home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 009a / logicat.zip / LC.DOC < prev    next >
Text File  |  1990-03-20  |  120KB  |  2,935 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                               LogiCat Disk Cataloger
  34.                        "Software Solutions that make Sense"
  35.  
  36.                         Copyright (c)1990, By Curtis Little
  37.                                 All Rights Reserved
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                  For IBM PCs, XTs, ATs, PS/2s and 100% Compatibles
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                                                           Table of Contents
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.      License  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  77.  
  78.      Warranty   . . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  79.  
  80.      Acknowledgments  . . . . . . . . . . . . . . . . . . . . . . . . .   3
  81.  
  82.      How to Contact the Support Board   . . . . . . . . . . . . . . . .   3
  83.  
  84.      Required Equipment   . . . . . . . . . . . . . . . . . . . . . . .   3
  85.  
  86.      Introduction   . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  87.  
  88.      Using Logicat  . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  89.           Installation  . . . . . . . . . . . . . . . . . . . . . . . .   5
  90.           Setup   . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  91.           Tutorial  . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  92.           Starting Up LogiCat   . . . . . . . . . . . . . . . . . . . .   6
  93.  
  94.      LogiCat Reference  . . . . . . . . . . . . . . . . . . . . . . . .  11
  95.           LogiCat Files   . . . . . . . . . . . . . . . . . . . . . . .  11
  96.           Editing String Fields   . . . . . . . . . . . . . . . . . . .  11
  97.           Global Command Keys   . . . . . . . . . . . . . . . . . . . .  12
  98.           Using Regular Expressions   . . . . . . . . . . . . . . . . .  13
  99.           Searching   . . . . . . . . . . . . . . . . . . . . . . . . .  16
  100.           Sorting Records   . . . . . . . . . . . . . . . . . . . . . .  16
  101.           Selecting Specific Records  . . . . . . . . . . . . . . . . .  18
  102.           LogiCat Menu Options  . . . . . . . . . . . . . . . . . . . .  21
  103.           Add Menu  . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  104.                Log Floppy Disks   . . . . . . . . . . . . . . . . . . .  23
  105.                Dummy Entry  . . . . . . . . . . . . . . . . . . . . . .  23
  106.                Add/mod Comments   . . . . . . . . . . . . . . . . . . .  23
  107.           Delete/replace Menu   . . . . . . . . . . . . . . . . . . . .  27
  108.                Replace a Disk   . . . . . . . . . . . . . . . . . . . .  27
  109.                Rename a Disk  . . . . . . . . . . . . . . . . . . . . .  28
  110.                Delete a Disk  . . . . . . . . . . . . . . . . . . . . .  28
  111.                Zap Database   . . . . . . . . . . . . . . . . . . . . .  28
  112.           Search Menu   . . . . . . . . . . . . . . . . . . . . . . . .  28
  113.                Browse Files   . . . . . . . . . . . . . . . . . . . . .  29
  114.                String Search  . . . . . . . . . . . . . . . . . . . . .  29
  115.                Comment Search   . . . . . . . . . . . . . . . . . . . .  29
  116.                Keyword Search   . . . . . . . . . . . . . . . . . . . .  30
  117.                File Search  . . . . . . . . . . . . . . . . . . . . . .  30
  118.                Case Sensitivity   . . . . . . . . . . . . . . . . . . .  30
  119.           Reports Menu  . . . . . . . . . . . . . . . . . . . . . . . .  30
  120.                Volume Report  . . . . . . . . . . . . . . . . . . . . .  31
  121.                Quick Volume Report  . . . . . . . . . . . . . . . . . .  32
  122.                File/Ext Report  . . . . . . . . . . . . . . . . . . . .  32
  123.                Quick File/Ext Report  . . . . . . . . . . . . . . . . .  32
  124.                Duplicate Files  . . . . . . . . . . . . . . . . . . . .  33
  125.                43/50 Line Mode  . . . . . . . . . . . . . . . . . . . .  33
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.           Options Menu  . . . . . . . . . . . . . . . . . . . . . . . .  33
  134.                Catalog Options  . . . . . . . . . . . . . . . . . . . .  33
  135.                Printer Options  . . . . . . . . . . . . . . . . . . . .  39
  136.                Color Options  . . . . . . . . . . . . . . . . . . . . .  41
  137.                Logging Drive(s)   . . . . . . . . . . . . . . . . . . .  41
  138.                Read New Database  . . . . . . . . . . . . . . . . . . .  41
  139.                Write Database   . . . . . . . . . . . . . . . . . . . .  41
  140.                Library Extensions   . . . . . . . . . . . . . . . . . .  41
  141.                Maximum Files Etc.   . . . . . . . . . . . . . . . . . .  41
  142.                Load Configuration   . . . . . . . . . . . . . . . . . .  42
  143.                Save Configuration   . . . . . . . . . . . . . . . . . .  42
  144.                Reset to Defaults  . . . . . . . . . . . . . . . . . . .  42
  145.           Utilities Menu  . . . . . . . . . . . . . . . . . . . . . . .  43
  146.                Import Comments  . . . . . . . . . . . . . . . . . . . .  43
  147.                DOS Shell  . . . . . . . . . . . . . . . . . . . . . . .  46
  148.           Quit Menu   . . . . . . . . . . . . . . . . . . . . . . . . .  46
  149.  
  150.      Index  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  47
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.         License
  159.  
  160.         You  are granted  a license  to evaluate  this software  on A SINGLE
  161.         COMPUTER for a  period not to exceed  thirty (30) days.   If,  on or
  162.         before  this time expires, you wish to continue using this software,
  163.         you  must register  by sending  the registration  fee to  the author
  164.         "Curtis Little" for EACH COPY to be used.
  165.  
  166.         The  shareware version of this software may be freely distributed as
  167.         long as the following conditions are met:
  168.  
  169.           1)   All files are distributed as is and in unmodified form.
  170.  
  171.           2)   No more than a $5.00 handling fee can be charged without the
  172.                PRIOR written consent of the author "Curtis Little".
  173.  
  174.           3)   LogiCat may  not be  distributed with  or as  a part  of any
  175.                other product or software package  without the prior written
  176.                consent of the author "Curtis Little".
  177.  
  178.         Registered  copies of  this software may  be used by  the REGISTERED
  179.         OWNER on a single  computer.  If you desire  to use the  software on
  180.         more than one computer you must purchase a site license.
  181.  
  182.         Business  and government users of  LogiCat must register in order to
  183.         legally  use  LogiCat.   The  30 day  evaluation  privilege is  only
  184.         extended to non-business users.
  185.  
  186.         By  using LogiCat you acknowledge that you have read this agreement,
  187.         understand it and agree to be bound by it's terms and conditions.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.         LogiCat License                                                   1
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.         Warranty
  217.  
  218.         With respect  to the  physical diskette  sent to registered  owners,
  219.         the author warrants  the same to be  free from defects  in materials
  220.         and  workmanship  for  a  period  of  60  days  from   the  date  of
  221.         registration.   In  the event  of notification  within the  warranty
  222.         period  of  defects  in  material or  workmanship  the  author  will
  223.         replace  the  defective diskette.   The  remedy for  breach of  this
  224.         warranty shall be  limited to  replacement and  shall not  encompass
  225.         any other damages, including but not limited to  loss of profit, and
  226.         special, incidental, consequential, or other similar claims.
  227.  
  228.         The author  specifically disclaims  all other  warranties, expressed
  229.         or implied,  including  but not  limited  to  implied warranties  of
  230.         merchantability  and  fitness  for  a  particular  purpose  and  the
  231.         program  license granted herein  in particular, and without limiting
  232.         operation  of the  program  license with  respect to  any particular
  233.         application, use,  or  purpose.   IN NO  EVENT SHALL  THE AUTHOR  BE
  234.         LIABLE  FOR ANY LOSS OF  PROFIT, LOST SAVINGS, COMMERCIAL DAMAGE, OR
  235.         OTHER  INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
  236.         INABILITY TO USE LOGICAT  EVEN IF THE AUTHOR  (Curtis Little) OR  AN
  237.         AUTHORIZED   DISTRIBUTOR  OF   LOGICAT  HAS  BEEN   ADVISED  OF  THE
  238.         POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  239.  
  240.         This  agreement shall  be  governed  by  the laws  of  the state  of
  241.         California.
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.         2                                                  Logicat Warranty
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.         Acknowledgments
  275.  
  276.         In this manual several products are referred to:
  277.  
  278.           MS-DOS is a registered trademark of Microsoft Corporation.
  279.  
  280.           Brief is a registered trademark of Underware, Inc.
  281.  
  282.           IBM PC, XT, AT, and PS/2 are trademarks of International Business
  283.           Machines, Inc.
  284.  
  285.           ARC is a trademark of System Enhancement Associates
  286.  
  287.           PKZIP is a trademark of PKWARE, INC.
  288.  
  289.  
  290.         How to Contact the Support Board
  291.  
  292.         An electronic bulletin board  is used to  support LogiCat.  You  may
  293.         contact the support board 24 hours a day.  The support board is:
  294.  
  295.           Lost At C BBS
  296.           (209) 521-2143
  297.  
  298.         In  addition you  may contact  the author  (Curtis Little)  on (209)
  299.         522-9269.   Be aware that if I need to call you back I will do so as
  300.         a collect call.  Don't leave a message for a call  back if you don't
  301.         desire to be called collect.
  302.  
  303.         If  you have  any questions/suggestions regarding  LogiCat feel free
  304.         to  call.   The  support  board  is  open  to the  public,  however,
  305.         registered users will receive priority service.
  306.  
  307.  
  308.         Required Equipment
  309.  
  310.           IBM PC, XT, AT, PS/2 or 100% Compatible
  311.           MDA, CGA, MCGA, EGA, or VGA display adapter
  312.           Hard disk (not required, but highly recommended)
  313.           MS-DOS 2.0 or above
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.         LogiCat, Disk Cataloger                                           3
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.         Introduction
  333.  
  334.         How many times have you  wanted to use that  "special" file, only to
  335.         find you have to search through hundreds  of disks searching for the
  336.         one file  you need?  LogiCat is  the solution!  With LogiCat in your
  337.         corner  you'll beat the lost file blues, determining the location of
  338.         files with the touch of a few keys.
  339.  
  340.         LogiCat goes well  beyond what  a standard  disk cataloging  program
  341.         does.   With LogiCat  you're using  state of  the art  in cataloging
  342.         software.  Just look at a few of the  advanced features supported by
  343.         LogiCat:
  344.  
  345.           o    Multi-line comments.   You will  no longer be  limited to  a
  346.                single line comment.  LogiCat supports a memo style comment,
  347.                allowing up to  500 characters describing  each file in  the
  348.                database.
  349.  
  350.           o    Advanced  word  processing  features are  supported  in  the
  351.                comment editor.  LogiCat has a  built in comment editor that
  352.                supports word  wrap along  with *many*  commands similar  to
  353.                those used by the Brief Editor.
  354.  
  355.           o    LogiCat supports  FULL REGULAR  EXPRESSION searching.   Once
  356.                you see how  powerful regular expressions are  for searching
  357.                you'll wonder how you ever got along without them.
  358.  
  359.           o    LogiCat supports multi-level sorting.  In addition any field
  360.                can be sorted in ascending or descending order.
  361.  
  362.           o    LogiCat supports the  extended 43/50  line mode for  EGA/VGA
  363.                monitors in the report mode.
  364.  
  365.           o    LogiCat supports automatic  disk naming.  This  includes use
  366.                of a "template" name.
  367.  
  368.           o    Advanced memory management in LogiCat  handles *many* of the
  369.                possible  memory  shortage  problems  without  aborting  the
  370.                program!
  371.  
  372.         These  are just a *few* of the many features  that set LogiCat apart
  373.         from  other cataloging  programs.   After  trying LogiCat  I'm  sure
  374.         you'll  agree  that  LogiCat is  setting  a  new standard  for  disk
  375.         cataloging software.
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.         4                                               LogiCat Users Guide
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.         This  manual explains how to  use LogiCat.  The two main sections to
  391.         the manual as follows:
  392.  
  393.           Using LogiCat
  394.           LogiCat Reference
  395.  
  396.         The  next section covers the  use of LogiCat in detail.  LogiCat was
  397.         designed to be simple  to use, however,  for those who desire  extra
  398.         features, there  are many hidden features  in LogiCat.   Each of the
  399.         features will be explained in the following sections.
  400.  
  401.  
  402.         Using Logicat
  403.  
  404.         This section details the use  of LogiCat.  If you are a new user you
  405.         should  read the tutorial section followed by the reference section.
  406.         Experienced  users  may  wish  to  skip  directly to  the  reference
  407.         section.  This documentation assumes  that LogiCat was  installed on
  408.         a hard  disk in  it's own  subdirectory.   If you installed  LogiCat
  409.         different  than described  in the  "Installation" section  to follow
  410.         there will be slight differences from the instructions.
  411.  
  412.  
  413.         Installation
  414.  
  415.         To install  LogiCat  you  should create  a subdirectory  to  contain
  416.         LogiCat and it's  data files.   In  this manual  it will be  assumed
  417.         that LogiCat is installed in the C:\LC directory.
  418.  
  419.         To  install LogiCat  you should create  a subdirectory on  your hard
  420.         drive  and then copy all the LogiCat files to that directory.  After
  421.         you  are finished  installing LogiCat  the directory  should contain
  422.         the following files:
  423.  
  424.           LC.EXE
  425.           LC.CFG
  426.  
  427.         If  you  desire to  execute  LogiCat without  having  to  be  in the
  428.         LogiCat  directory  you  need  to  modify your  path  statement  (in
  429.         AUTOEXEC.BAT).    For instance,  assume the  following statement  is
  430.         already in C:\AUTOEXEC.BAT:
  431.  
  432.           PATH=C:\DOS3_3;C:\BIN;C:\WP
  433.  
  434.         After adding the LogiCat directory the statement should appear as:
  435.  
  436.           PATH=C:\DOS3_3;C:\BIN;C:\WP;C:\LC
  437.  
  438.         That's all there is to installing LogiCat!
  439.  
  440.         LogiCat, Disk Cataloger                                           5
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.         Setup
  451.  
  452.         When you first  start LogiCat it  is setup with  the default  values
  453.         that were supplied by the  program's author.  Since  you may wish to
  454.         change  the settings a  configuration utility is built into LogiCat.
  455.         In particular you may  wish to change the  default maximum number of
  456.         files, directories, and  disks (which  are normally  3000, 300,  and
  457.         300 respectively).  All  setup information can  be accessed  through
  458.         the 'Options'  menu.   For a full  description of  the Options  menu
  459.         refer to the section titled "Options Menu" on page 33.
  460.  
  461.  
  462.         Tutorial
  463.  
  464.         This section  goes into  an overview of  starting up  and using  the
  465.         LogiCat Disk  Cataloger.  If you  are an experienced user you should
  466.         skip this section and  go directly to the  reference section of this
  467.         documentation.
  468.  
  469.  
  470.         Starting Up LogiCat
  471.  
  472.         To start using LogiCat simply  type the following command at the DOS
  473.         prompt:
  474.  
  475.           LC
  476.  
  477.         (This assumes that you  are either in the LogiCat directory, or that
  478.         the LogiCat directory is in your path).
  479.  
  480.         There  are several optional parameters  that can be specified on the
  481.         startup  command  line.   The  optional  parameters allowed  are  as
  482.         follows:
  483.  
  484.           /B   Specifies to  use black and white mode.  If you specify this
  485.                option LogiCat  will only use  black and white  colors (with
  486.                the  exception  of  the  opening  and  end  screens  in  the
  487.                shareware version).
  488.  
  489.           /C CFG_FILE:  Specifies the name of the configuration file.
  490.                If  you  don't  specify  this  option LogiCat  looks  for  a
  491.                configuration file named LC.CFG.
  492.  
  493.           /D DATA_BASE:  Specifies the name of a data base file.  If you
  494.                don't specify  this option LogiCat  looks for the  data base
  495.                named  in  the   configuration  file  (if  there   wasn't  a
  496.  
  497.  
  498.         6                                               LogiCat Users Guide
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.                configuration file LogiCat  uses a default data base name of
  507.                LC.DB).
  508.  
  509.           /M ADAPTER_TYPE:  Specifies the type of adapter to use.  Normally
  510.                you  shouldn't use  this  option since  LogiCat  is able  to
  511.                detect  the adapter  properly  on startup.    If you're  not
  512.                having problems with the LogiCat  video output DON'T specify
  513.                this option.  If you do need to specify the adapter type you
  514.                should  report your  adapter type  to  the support  board so
  515.                future  versions of  LogiCat will  automatically detect  the
  516.                adapter type.   The valid adapters are:  MDA,  CGA, EGA, and
  517.                VGA.
  518.  
  519.                WARNING:  Setting the adapter to  an invalid type will cause
  520.                unpredicatable results!
  521.  
  522.           /N   This option  specifies color  mode without  snow protection.
  523.                You  should use this  option if you have  a CGA that doesn't
  524.                require snow control.
  525.  
  526.           /O   This  option  specifies  color  mode with  snow  protection.
  527.                Video output is  slower with  this option than  with the  /N
  528.                option.
  529.  
  530.         After  starting LogiCat the  registration notice is displayed on the
  531.         screen  (this notice doesn't appear in the registered version of the
  532.         program).  After a 15 second delay, you  will be allowed to press  a
  533.         key to get past the notice screen.
  534.  
  535.         Next,  the  main LogiCat  menu  screen is  displayed.   This  screen
  536.         appears as follows:
  537.  
  538.         Add  Delete/replace   Search   Reports   Options   Utilities   Quit
  539.  
  540.            + Volume Labels ------------------------------------------------+
  541.            |     Use disk name as label? No     Delete existing label? No  |
  542.            | Use existing label as name? No                                |
  543.            +---------------------------------------------------------------+
  544.         + Catalog Options ---------------------------------------------------+
  545.         | Automatic disk naming? Yes Template: XX999999999  Last: LC000000000|
  546.         |                                                                    |
  547.         |      Keep subdir names? No            Backup database? No          |
  548.         |Extract library members? Yes   Extract library comments? Yes        |
  549.         | Flag duplicate records? Yes       Memory for DOS shell? 256K       |
  550.         |Ask for select criteria? Yes      Ask for sort criteria? Yes        |
  551.         |  Case sensitive search? Yes                                        |
  552.         |                                                                    |
  553.         |Printer Name: SCREEN                                                |
  554.         | Report Dest: PRN                                                   |
  555.  
  556.         LogiCat, Disk Cataloger                                           7
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.         +--------------------------------------------------------------------+
  565.  
  566.          Log Drive(s):  A:  | C:LC   |   2 Disks |  1168 Files | 436K Free
  567.  
  568.                                      LogiCat Disk Cataloger
  569.                                Copyright (c)1990 By Curtis Little
  570.                                       All Rights Reserved
  571.  
  572.  
  573.         You will notice there are 5 parts to the main screen as follows:
  574.  
  575.           1)   Main menu bar  (the top line of the screen)
  576.  
  577.           2)   Volume label options window
  578.  
  579.           3)   Catalog options window
  580.  
  581.           4)   Status line (just below the catalog options window)
  582.  
  583.           5)   Program title and copyright message
  584.  
  585.         The  main menu  bar is  the bar  displayed on  the  top line  of the
  586.         screen.  This  is a pull-down  type menu that  allows you  to access
  587.         the other submenus  within LogiCat.   To access one of  the submenus
  588.         you would press  the ALT key at the same time as the first letter of
  589.         the desired submenu.  The following submenus are provided:
  590.  
  591.           1)   Add  -  This submenu  allows  you  to add  disks  (scans the
  592.                files), add comments, and add disk volumes to the database.
  593.  
  594.           2)   Delete/Replace - This  submenu allows  you to delete  disks,
  595.                replace an existing disk, and rename disks in the database.
  596.  
  597.           3)   Search - This  submenu allows you  to browse and search  the
  598.                files for desired entry(s).
  599.  
  600.           4)   Reports - This submenu allows you to choose and print any of
  601.                the supported reports.
  602.  
  603.           5)   Options  -  This submenu  allows  you to  configure LogiCat,
  604.                load/save configuration files, load/write databases, and set
  605.                the colors used.
  606.  
  607.           6)   Utilities  - This  submenu  allows you  to  use the  utility
  608.                programs that  are  a  part  of  LogiCat.    Currently  this
  609.                consists of a comment  import utility.  In addition  you can
  610.                shell to  DOS from  this menu  (but as  you'll learn  later,
  611.                LogiCat allows  you to  shell to  DOS from  ANYWHERE in  the
  612.                program by use of a hotkey!).
  613.  
  614.         8                                               LogiCat Users Guide
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.           7)   Quit - This submenu  allows you to exit LogiCat.   (Pressing
  624.                ESCape enough times allows you to exit the program as well).
  625.  
  626.         The option settings  window area of  the main screen  shows most  of
  627.         the  LogiCat configuration settings.  Since the defaults are good in
  628.         most  cases  a discussion  of the  various option  settings will  be
  629.         delayed  until the reference  section of  the manual.   Refer to the
  630.         section titled 'Options Menu' on page 33 for details.
  631.  
  632.         The  status line  contains  a  mixture of  configuration  data,  and
  633.         miscellaneous  data.   The  status line  is near  the bottom  of the
  634.         screen and appears similar to the following:
  635.  
  636.          Log Drive(s):  A:  | C:LC   |   2 Disks |  1168 Files | 436K Free
  637.                         ^       ^        ^          ^            ^
  638.                         |       |        |          |            |
  639.                        (1)     (2)      (3)        (4)          (5)
  640.  
  641.           1)   Logging drive(s) -  the drives that are  scanned for logging
  642.                files to the database.
  643.  
  644.           2)   Database name -  this is the  name of  the database that  is
  645.                currently being operated on.
  646.  
  647.           3)   Number of disks in the database that's in memory.
  648.  
  649.           4)   Number of files in the database that's in memory.
  650.  
  651.           5)   Approximate amount of free memory.
  652.  
  653.         Ok,  now lets  go through  the  steps needed  to  add  disks to  the
  654.         database.  For this tutorial it will be assumed that automatic  disk
  655.         naming  is turned  off.  To log  your floppy disks  you should press
  656.         ALT-A (while  on the main  screen) to  get to  the Add  menu.   From
  657.         there choose the first option  'Log a disk'.   After choosing 'Log a
  658.         disk'  you will be  prompted to insert a disk  in the logging drive.
  659.         After inserting  the disk press  the ENTER  key to  start.   LogiCat
  660.         will prompt for  the disk name and  then automatically add the  disk
  661.         contents  to the database.   After scanning the disk LogiCat prompts
  662.         for  the next disk.   You  can continue logging  disks by continuing
  663.         the procedure described above.
  664.  
  665.         After  you're finished  logging disks  press the  ESCape key  to get
  666.         back to the add menu.  You'll find that the ESCape  key is used as a
  667.         general  purpose "quit/abort"  key.   Pressing the  ESCape  key will
  668.         always drop you back a level in LogiCat.
  669.  
  670.  
  671.  
  672.         LogiCat, Disk Cataloger                                           9
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.         Now you can try some of the other  program options.  Press ALT-R  to
  681.         go to  the reports menu, and  then press the 'E'  key to select  the
  682.         quick file/ext report.  After  pressing the 'e' key a report will be
  683.         displayed on the screen showing the files  that were on the floppies
  684.         that  you just logged (the list will be sorted  in file name order).
  685.         If the  listing is longer  than one  page you  can use the  PgUp and
  686.         PgDn to move between the report pages.  
  687.  
  688.         There are other  options available at  the report  page as well,  to
  689.         see  one of these  press the 'S' key to ask  for a search.  A window
  690.         will be displayed asking for the  search data.  Type in  the name of
  691.         a file that was on one of  the disks that you logged, and then press
  692.         the ENTER key.   LogiCat  will automatically move  to the page  that
  693.         has the file and highlight the matching file for you!
  694.  
  695.         Pressing  the ESCape key will  bring you back to  the report submenu
  696.         again, or if you're on the last page of the  report pressing any key
  697.         will take you back to the menu.
  698.  
  699.         Now, lets quit  out of the  program.  Press  ESCape two  times (from
  700.         the report menu) to  exit out of LogiCat.  Note that the database is
  701.         automatically saved when  you exit LogiCat.   You can also save  the
  702.         database  at any  time by using  the 'Write database'  option on the
  703.         Options menu.
  704.  
  705.         You  now have  a general  feel for using  LogiCat!  You  may wish to
  706.         read  the  reference section,  paying  particular attention  to  the
  707.         section  dealing with  the options  allowed in  LogiCat.   As you've
  708.         already  seen, using  LogiCat  is  pretty easy.    LogiCat  smoothly
  709.         blends state of  the art in power  with ease of  use to  provide you
  710.         with the best cataloger available!
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.         10                                              LogiCat Users Guide
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.         LogiCat Reference
  739.  
  740.         This  section  of the  manual  goes into  detail  about the  various
  741.         commands  and  options  available in  LogiCat.    If you're  new  to
  742.         LogiCat  you may  wish to read  the tutorial (above)  before reading
  743.         the reference.  Before  covering each of the menu options in  detail
  744.         we'll go over a few  of the windows that are used in multiple  parts
  745.         of LogiCat.   In  this  chapter the  "global" command  keys will  be
  746.         explained  followed by  a section covering  regular expressions, and
  747.         sections on all the menu options currently available in LogiCat.
  748.  
  749.  
  750.         LogiCat Files
  751.  
  752.         LogiCat maintains several files to keep track  of things such as the
  753.         settings  and the databases.   You can generally tell what a file is
  754.         used for  by the extension.   This isn't  a set  rule since  you can
  755.         override  *some* of  the extensions,  but it  is suggested  that you
  756.         accept  the  default  extension.   Anytime  you  save  a  file  with
  757.         LogiCat,  if you  don't specify the  extension the default  for that
  758.         type of file will be used.  The various file types are:
  759.  
  760.           Extension      File is used for
  761.           ---------      ----------------
  762.           .DB            Database                 (Can't override)
  763.           .CFG           Configuration file       (Can override)
  764.           .IMP           Import comment settings  (Can override)
  765.           .BAK           Backup database files    (Can't override)
  766.  
  767.         When  you  scan  a disk  LogiCat  actually  maintains two  databases
  768.         instead of  one.  The information  about the file  names, sizes, etc
  769.         are in one database, and the comments are stored  in a separate one.
  770.         In order  to make the  use of multiple  databases as transparent  as
  771.         possible,  LogiCat only  asks for one database  name and tracks both
  772.         databases from that.  The comment database has the  same name as the
  773.         "main" database with a '1' appended.
  774.  
  775.  
  776.         Editing String Fields
  777.  
  778.         There are many places  where LogiCat needs to obtain an input string
  779.         from the  keyboard.  With the  exception of the  comment editor, all
  780.         field input  goes through the  LogiCat string editor.   To  help you
  781.         better  use  the string  editor  the  following is  a  list  of  the
  782.         commands available while you're entering input:
  783.  
  784.            BackspaceHas the traditional meaning of a backspace (traditional
  785.                     for the PC).  This deletes the character to the left of
  786.                     the cursor and moves the cursor one position left.
  787.  
  788.         LogiCat, Disk Cataloger                                          11
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.           CTRL U    Press CTRL U to abort all changes you made to the input
  798.                     field.    This restores  the  original contents  of the
  799.                     string.
  800.  
  801.           CTRL Y    This key combination deletes the entire contents of the
  802.                     input field.
  803.  
  804.           DELete    This deletes the character that is under the cursor.
  805.  
  806.           Down arrow - Moves to the next field in multi-field input.
  807.  
  808.           END       Moves the cursor to the end of the field.
  809.  
  810.           ESCape    Abort  input  losing changes  to  the string  you where
  811.                     editing.
  812.  
  813.           HOME      Moves the cursor to the home position (1st position) of
  814.                     the input field.
  815.  
  816.           Left arrow - moves the cursor to the left.
  817.  
  818.           Right arrow - moves the cursor to the right.
  819.  
  820.           Up arrow  In  multi-field  input  this moves  the  cursor  to the
  821.                     previous field.
  822.  
  823.           RETURN    Press  the  return/enter  key  when  you  are  finished
  824.                     editing the string.
  825.  
  826.         If  there  is a  default value  for the  string the  cursor will  be
  827.         positioned after the last  character in the string.   If you  desire
  828.         to edit  the "default" value  you should press  one of the  commands
  829.         listed  above as the  first key.  Pressing  a valid letter/number as
  830.         the  first key causes the default value to be  replaced by the typed
  831.         letter.  After the first key you can type whatever you like.
  832.  
  833.  
  834.         Global Command Keys
  835.  
  836.         There  are several  global command  keys provided  in LogiCat.   The
  837.         first is the ESCape key.   Pressing the ESCape key causes LogiCat to
  838.         abort  the  current operation  and return  to the  previous "level".
  839.         For  instance, if  one of  the submenus  is displayed,  pressing the
  840.         ESCape  key  will cause  the submenu  to disappear  and you  will be
  841.         returned  to the  main menu  level (until you  press one of  the ALT
  842.         letter keys to activate a submenu again).  Anytime  you want to back
  843.         out of whatever you're doing in LogiCat  you should press the ESCape
  844.         key.  If aborting the current operation would cause  changed data to
  845.  
  846.         12                                              LogiCat Users Guide
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.         be  lost  you  will  be prompted  before  the  abort  is  performed.
  855.         Pressing the ESCape key at a yes/no question is  treated the same as
  856.         answering the question 'No'.
  857.  
  858.         LogiCat  also  provides a  global  DOS  shell  command.   *Anywhere*
  859.         LogiCat is waiting for a  keystroke you can press  ALT-Z to shell to
  860.         DOS!   The DOS prompt  will be modified to remind you you're shelled
  861.         out of LogiCat.   Typing EXIT at the DOS prompt will return you back
  862.         to LogiCat.  Note that LogiCat  uses Switch! allowing you to specify
  863.         how  much  memory to  make  available  for the  DOS  shell.   It  is
  864.         possible  to  make  virtually  *all*  the  memory  used  by  LogiCat
  865.         available  for the shell since Switch! is used.  The Switch! feature
  866.         is covered in the options section of this manual.
  867.  
  868.  
  869.         Using Regular Expressions
  870.  
  871.         LogiCat  has  the   most  powerful  regular   expression  facilities
  872.         available  in a disk cataloging program at any price (as of the time
  873.         of this  writing).   Those familiar  with Brief  will feel  right at
  874.         home  with LogiCat's regular  expressions, since the LogiCat regular
  875.         expression  facilities  are  virtually identical  to  those  in  the
  876.         popular Brief  editor.   Any  time  you're  searching for  something
  877.         you're  allowed  to  use  regular  expressions  (this  includes  the
  878.         selection  criteria and  search data to  be discussed later  in this
  879.         manual).
  880.  
  881.         For  those  not  familiar with  regular  expressions,  they  will be
  882.         defined here.  Basically, even  if you don't know  it yet, you  most
  883.         likely  know about some regular expressions.  For instance, have you
  884.         ever typed a DOS command similar to:
  885.  
  886.           DIR *.DOC
  887.  
  888.         DOS supports a  very limited  set of regular expression  characters,
  889.         but those who know about  wildcard characters such as the '?' or '*'
  890.         use a type of regular expression already.
  891.  
  892.         In  short,  a  regular  expression  is  a  pattern  that  represents
  893.         character  sequences.   A regular  expression can  be thought  of as
  894.         having two basic types  of characters in  it.  A regular  expression
  895.         is  composed of normal characters (such as letters and numbers), and
  896.         regular expression "metacharacters".   The  metacharacters are  what
  897.         gives regular expressions their power.
  898.  
  899.         LogiCat    supports   virtually    the   same   regular   expression
  900.         metacharacters as the Brief editor.  These metacharacters are:
  901.  
  902.  
  903.  
  904.         LogiCat, Disk Cataloger                                          13
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.           *    Matches  any  number of  occurrences  (0  or  more)  of  any
  913.                character.  The  * matches as  few occurrences as needed  to
  914.                make the rest of the pattern match.
  915.  
  916.                g*d matches god, good, egad, and gillard
  917.  
  918.                but not:
  919.  
  920.                dog, goat
  921.  
  922.           ?    Matches any single character.
  923.  
  924.                c?t matches cat and cut, but not cant
  925.  
  926.           @    Matches 0 or more occurrences  of the preceding character or
  927.                pattern.  Note that  with @ the fewest  possible occurrences
  928.                of a pattern will be considered a match.
  929.  
  930.                go@d matches gd, god, good, goood, gooood, etc..
  931.  
  932.           +    Matches 1 or more occurrences of the  preceding character or
  933.                pattern.  This  is the same as the @ except that one or more
  934.                occurrences are needed to match.
  935.  
  936.                go+d matches god, good, goood, gooood, etc...
  937.  
  938.                but not gd, ggdoddd
  939.  
  940.           |    Matches  either  the  preceding  pattern  OR  the  following
  941.                pattern.
  942.  
  943.                b|c matches either b or c
  944.  
  945.                this|that doesn't  match what  you might  think, it  matches
  946.                either thishat or  thithat.  To see  how to do a  search for
  947.                either of the words (this or that) see the next category  of
  948.                regular expression characters.
  949.  
  950.           {}   Groups  characters  or  patterns  together  for  a   search.
  951.                Grouping characters provides several features:
  952.  
  953.                     1)   Provides a way to control  how regular expressions
  954.                          are  evaluated   (i.e.  like   parenthesis  in   a
  955.                          mathematical equation).
  956.  
  957.                     2)   Groups a set of text together.
  958.  
  959.                For example, in  the discussion of  the or operator (|)  you
  960.                saw the  expression:  this|that didn't match  the words this
  961.  
  962.         14                                              LogiCat Users Guide
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.                or that as might  be expected.  Using grouping you  can make
  971.                this work as follows:
  972.  
  973.                     {this}|{that}
  974.  
  975.                The example above would find occurrences of this or that.
  976.  
  977.                {ok}+
  978.  
  979.                Matches one or more occurrences of the word ok.
  980.  
  981.           []   This creates a "set" of characters to search for.  There are
  982.                several powerful forms of the set operator.
  983.  
  984.                [~]  Matches a character if it IS  NOT any of the characters
  985.                     between the [~ and the ].
  986.  
  987.                [-]  Matches a  RANGE of  characters.   For example,  [a-z].
  988.                     The beginning range  character must have a  lower value
  989.                     than the upper value.
  990.  
  991.                [a-z0-9A-Z]
  992.  
  993.                This example matches all letters  (upper and lower case) and
  994.                numbers.  This would match:
  995.  
  996.                     abra12, 123x134, 23, and hello
  997.  
  998.                but not:  it's and "first"
  999.  
  1000.                [~a-zA-Z]
  1001.  
  1002.  
  1003.           This example matches everything that isn't a letter.
  1004.  
  1005.           \    Override character.   The backslash  allows you to  override
  1006.                the normal meaning of a character.
  1007.  
  1008.                \* searches for the actual  character * instead of  treating
  1009.                the * as a regular expression as it normally would be.
  1010.  
  1011.                \\ allows you to search for the backslash in a string.
  1012.  
  1013.                \[ allows  you to search  for the  left bracket,  overriding
  1014.                the standard usage of  the left bracket as the opening  of a
  1015.                set definition.
  1016.  
  1017.         The  precedence  for evaluating  regular expressions  is as  follows
  1018.         (going from highest precedence to the lowest):
  1019.  
  1020.         LogiCat, Disk Cataloger                                          15
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.           {}        Groups have the highest precedence.   Characters inside
  1030.                     a group are treated as a single expression.
  1031.  
  1032.           |, @, +   Matches from the  left to  the right.   These have  the
  1033.                     second highest precedence.
  1034.  
  1035.           All other characters have equal precedence with each other.
  1036.  
  1037.  
  1038.         Searching
  1039.  
  1040.         There  are several  places in  LogiCat where  you can enter  data to
  1041.         search  for.  Anytime you  specify you want  to search for something
  1042.         the  search window  is popped  up to  get the  search options.   The
  1043.         search window appears as follows:
  1044.  
  1045.         + Search Data ----------------------------------------------------------+
  1046.         |>                                                                      |
  1047.         |                                                                       |
  1048.         | Search: ( X ) File/Ext  ( X ) Disk   ( X ) Keywords   ( X ) Comments  |
  1049.         |                       (   )  Search Backward                          |
  1050.         |    |                                                                  |
  1051.         |  <-+ to Search,  TAB: Next Field,  BackTAB: Prev Field,  ESC: Abort   |
  1052.         | (Regular Expressions Are Allowed)                Case IS significant. |
  1053.         +-----------------------------------------------------------------------+
  1054.  
  1055.         When  the search window is  displayed the cursor is put in the input
  1056.         field waiting for you to  type the data to search  for.  You'll note
  1057.         that there are several "fields"  in the search window.   You can get
  1058.         to  the other  fields by  using the TAB,  BACKTAB, UP ARROW  and the
  1059.         DOWN ARROW.  All other  fields in the window  with the exception  of
  1060.         the input  field are toggles.   Pressing the  space bar toggles  the
  1061.         setting of  the associated  option.   When it is  blank it is  off. 
  1062.         Pressing the ENTER key starts the search.
  1063.  
  1064.         Note  that  you can  use  regular expressions  in  the search  data.
  1065.         LogiCat automatically appends a '*' to the beginning and  the end of
  1066.         the data to search for  (this allows LogiCat to find the data within
  1067.         a string).
  1068.  
  1069.         If  you want the search  to be fast,  don't search the comment field
  1070.         since the comments must be read from disk.
  1071.  
  1072.  
  1073.         Sorting Records
  1074.  
  1075.         LogiCat  provides  the  user  with one  of  the  most  flexible  and
  1076.         powerful  sorting routines available  in a  cataloging program.  One
  1077.  
  1078.         16                                              LogiCat Users Guide
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.         of  the LogiCat options controls whether or not you are prompted for
  1087.         the sort options  when you select  a menu item that  allows sorting.
  1088.         For this discussion it is  assumed that you have LogiCat optioned to
  1089.         ask for the sort options  (the default).  If you  wish to know  more
  1090.         about  the LogiCat  options you should  refer to the  section titled
  1091.         'Options  Menu' on  page 33.     Picking one  of the  following menu
  1092.         items causes LogiCat to prompt you for the sort options:
  1093.  
  1094.           1)   Add/mod comments
  1095.  
  1096.           2)   Browse files
  1097.  
  1098.           3)   File/ext report
  1099.  
  1100.         (There is one  more menu item that  causes a different  sort options
  1101.         window  to be displayed.   This sort window is covered later in this
  1102.         section).   When you  pick one of  the menu  items listed  above the
  1103.         following window  is displayed when LogiCat is ready to get the sort
  1104.         options:
  1105.  
  1106.         + Sort Options ----------------------------------------------+
  1107.         |    [-]1 - File Name                [-]6 - Comments         |
  1108.         |    [-]2 - File Ext                 [-]7 - Date & Time   <-----+
  1109.         |    [-]3 - Subdir                   [-]8 - Size             |  |
  1110.         |    [-]4 - Disk Name                [-]9 - Library Name     |  |
  1111.         |    [-]5 - Keywords                 [-]10 - Library Ext     |  |
  1112.         |                                                            |  |
  1113.         |    Enter sort fields separated by spaces (ESC to abort)    |  |
  1114.         |       Use - to specify descending order for a field        |  |
  1115.         |                0 or BLANK list for no sort                 |  |
  1116.         |>                                                           |  |
  1117.         +---- ^ -----------------------------------------------------+  |
  1118.               |                                                         |
  1119.            Field list input string
  1120.                                                             List  of  field
  1121.                                                             numbers you can
  1122.                                                             sort on.
  1123.  
  1124.         The  cursor is placed in  the input field  and LogiCat waits for you
  1125.         to  type a list  of field numbers to  sort.  If you  wish to sort on
  1126.         more than one  field you should  type in the  list of  field numbers
  1127.         separated by spaces.   Preceding a  field number  with a minus  sign
  1128.         indicates  you wish to sort  the specified field in descending order
  1129.         (no  spaces should  be between  the -  and the  field number).   For
  1130.         example  to sort in ascending order on the file name, and descending
  1131.         order on the extension the list you type would be as follows:
  1132.  
  1133.           1 -2
  1134.  
  1135.  
  1136.         LogiCat, Disk Cataloger                                          17
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.         Assuming  you had  the following  files/extensions, the  chart below
  1145.         lists the sorted results using the field list from above:
  1146.  
  1147.           File Names               Sorted File Names
  1148.           ----------               -----------------
  1149.           LC.EXE                   AUTOEXEC.BAT
  1150.           AUTOEXEC.BAT             LC.PRN
  1151.           LC.CFG                   LC.EXE
  1152.           LC.PRN                   LC.CFG
  1153.           PKZIP.EXE                PKZIP.EXE
  1154.  
  1155.         A  special purpose  sort options window  is displayed if  you choose
  1156.         the Volume report  menu item.   The special  sort window appears  as
  1157.         follows:
  1158.  
  1159.         + Sort Options ----------------------------------------------+
  1160.         |    [-]1 - Disk Name                [-]5 - Free Space       |
  1161.         |    [-]2 - Keywords                 [-]6 - Total Space      |
  1162.         |    [-]3 - Comments                 [-]7 - Date Indexed     |
  1163.         |    [-]4 - Used Space                                       |
  1164.         |                                                            |
  1165.         |    Enter sort fields separated by spaces (ESC to abort)    |
  1166.         |       Use - to specify descending order for a field        |
  1167.         |                0 or BLANK list for no sort                 |
  1168.         |>                                                           |
  1169.         +------------------------------------------------------------+
  1170.  
  1171.         This sort selection window works like the one discussed above.   The
  1172.         only difference  is that  the items on  this window are  specific to
  1173.         disks instead of files  (since the volume report only lists the disk
  1174.         names in the database).
  1175.  
  1176.  
  1177.         Selecting Specific Records
  1178.  
  1179.         LogiCat  provides  the user  with  an  extremely flexible  method of
  1180.         selecting special/specific  records  through the  use of  "selection
  1181.         criteria".   One of the LogiCat options controls whether  or not you
  1182.         are prompted for the selection criteria when you select a menu  item
  1183.         that  allows selecting specific records.   For this discussion it is
  1184.         assumed  that you  have LogiCat  optioned to  ask for  the selection
  1185.         criteria (the default).  If  you wish to know more about the LogiCat
  1186.         options  you should  refer to the  section titled 'Options  Menu' on
  1187.         page 33.  Picking one of the following menu  items causes LogiCat to
  1188.         prompt you for the selection criteria:
  1189.  
  1190.           o Add/mod comments
  1191.  
  1192.           o Browse files
  1193.  
  1194.         18                                              LogiCat Users Guide
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.           o File/ext report
  1204.  
  1205.           o Duplicate files
  1206.  
  1207.         When  you pick  one of  the menu  items listed  above the  following
  1208.         window  is  displayed when  LogiCat is  ready to  get the  selection
  1209.         criteria:
  1210.  
  1211.         + Selection Criteria ----------------------------------------+
  1212.         | [-]1 - File Specs        [-]6 - Date Range                 |
  1213.         | [-]2 - Subdirs           [-]7 - Size Range                 |
  1214.         | [-]3 - Disk Names        [-]8 - Library Members            |
  1215.         | [-]4 - Keywords          [-]9 - Files with keywords        |
  1216.         | [-]5 - Comments         [-]10 - Files with comments        |
  1217.         |                                                            |
  1218.         | Enter selection options separated by spaces (ESC to abort) |
  1219.         |   Use - to exclude files based on the associated option    |
  1220.         |               0 or BLANK list for All Files                |
  1221.         |>                                                           |
  1222.         +------------------------------------------------------------+
  1223.  
  1224.         The cursor is placed in  the input field and  LogiCat waits for  you
  1225.         to type a list of  field numbers to perform the selection of special
  1226.         records  on.  You  may select files by any  combination of the above
  1227.         listed fields.   If you wish to specify more than one field to enter
  1228.         selection criteria for you should type in the list  of field numbers
  1229.         separated  by spaces (order is  not significant).  Preceding a field
  1230.         number with a minus sign indicates you wish to  exclude files by the
  1231.         selection  data for the associated  field.  Using the negative field
  1232.         causes  LogiCat to  reject those records that  match the criteria to
  1233.         be entered about the field  (no spaces should be  between the -  and
  1234.         the field number).  
  1235.  
  1236.         Depending  on the fields you wish to specify selection criteria for,
  1237.         LogiCat prompts you for the  selection options.  For the fields that
  1238.         require  you to  specify the selection  criteria there are  two main
  1239.         methods  of input.  The first method of entering  criteria is in the
  1240.         form  of  a  list  of  data  fields.    This  type of  input  method
  1241.         continually  prompts you  for additional selection  criteria for the
  1242.         field until you press return without typing any data.   In this type
  1243.         of mode the only limit  on the number of  different criteria you can
  1244.         specify  is the amount  of available memory to store  the data.  The
  1245.         following fields use this type of input method:
  1246.  
  1247.                o File specs                  o Keywords
  1248.  
  1249.                o Subdirs                     o Comments
  1250.  
  1251.  
  1252.         LogiCat, Disk Cataloger                                          19
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.                o Disk names
  1261.  
  1262.         You  can   make  full  use  of  regular  expressions  when  entering
  1263.         selection  data for any  of the above fields.   Refer to the section
  1264.         titled  'Using  Regular  Expressions' for  details  on  the  regular
  1265.         expression facilities provided in LogiCat.
  1266.  
  1267.         The second method of input  for selection criteria is  a range.   If
  1268.         you  specify one  of the  following  fields  you'll be  asked for  a
  1269.         SINGLE range to use as the selection criteria for the field:
  1270.  
  1271.           o Date
  1272.  
  1273.           o Size
  1274.  
  1275.         When  entering selection criteria you  enter values that you want to
  1276.         match in the  associated field.   For example let's  say you  want a
  1277.         report listing all executable files,  you would enter  the following
  1278.         as the selection field list:
  1279.  
  1280.           1
  1281.  
  1282.         Next,  LogiCat  would prompt  for  the  selection  criteria for  the
  1283.         filespecs.   To  select executable files the  following would be the
  1284.         file specs:
  1285.  
  1286.         +--------------- Selection Data : ESCape to Abort ---------------+
  1287.         | Enter selection File Specs, one per line.  Blank line to end.  |
  1288.         |                                                                |
  1289.         |File Specs (1): *.exe                                           |
  1290.         |File Specs (2): *.com                                           |
  1291.         |File Specs (3):                                                 |
  1292.         |                ^                                               |
  1293.         |                |                                               |
  1294.         |                |                                               |
  1295.         +--------------- | ----------------------------------------------+
  1296.                          |
  1297.           This is  the prompt  issued by  LogiCat for  the selection  data.
  1298.           Note that pressing return without entering anything  gets you out
  1299.           of input mode.
  1300.  
  1301.         LogiCat  would then  select only the records  that have an extension
  1302.         of EXE  or COM  when the  above criteria  is entered.    If you  had
  1303.         specified  other fields  LogiCat would  prompt for  the criteria for
  1304.         those fields, and then select on those fields as well.
  1305.  
  1306.         NOTE:  The criteria entered are INDEPENDENT.  If you enter selection
  1307.         criteria  for more  than one field,  the selected records  will only
  1308.  
  1309.  
  1310.         20                                              LogiCat Users Guide
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.         have  to match  something out  of ONE  set of  selection data.   You
  1319.         should use the "rejection" criteria to block undesired records.
  1320.  
  1321.  
  1322.         LogiCat Menu Options
  1323.  
  1324.         When  you first  start up  LogiCat you  are in  the main  menu mode.
  1325.         LogiCat's menu is a  pull-down type menu.  You can press the ALT key
  1326.         at the same time  as the first letter of  the menu item  you desire,
  1327.         and  a submenu will  be displayed.  Once you  have a sub-menu pulled
  1328.         down  you can use  the arrow keys  to change  submenus (the  ALT key
  1329.         combinations still work as well).
  1330.  
  1331.         Once a submenu is displayed you can choose  a menu item by using the
  1332.         up/down  arrow keys to highlight  the desired item and then pressing
  1333.         the ENTER  key to select  the item.   You may also  select a submenu
  1334.         item by pressing the highlighted letter for the desired item.
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.         LogiCat, Disk Cataloger                                          21
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.         The  following  chart illustrates  the  various menus  available  in
  1377.         LogiCat:
  1378.  
  1379.         +-------------------------< Main Menu >--------------------------+
  1380.         | Add  Delete/replace  Search  Reports  Options  Utilities  Quit |
  1381.         +----------------------------------------------------------------+
  1382.           ^               ^       ^        ^        ^          ^
  1383.           |               |       |        |        +-+        |
  1384.         Pressing ALT-A    \     Pressing   +-------+   \   Pressing ALT-U
  1385.         selects the        \    ALT-S               \   \   selects the 
  1386.         Add submenu.        \   selects the          \   \   Utilities menu
  1387.                              \  Search submenu        +   \      
  1388.         +---< Add Menu >---+  | +--< Search Menu >-+  |    \  +<Utilities Menu>+
  1389.         | Log floppy disks |  | | Browse files     |  |     | | Import comments|
  1390.         | Dummy entry      |  | | String search    |  |     | | DOS Shell      |
  1391.         | Add/mod comments |  | | Comment search   |  |     | +----------------+
  1392.         +------------------+  | | Keyword search   |  |     |
  1393.                               | | File search      |  |     | 
  1394.                               | | cAse sensitivity |  |     | 
  1395.                               | +------------------+  |     | 
  1396.                               |                       |     |
  1397.                   Pressing ALT-D           Pressing ALT-R   |
  1398.                   selects the              selects the       \
  1399.                   Delete submenu           Report submenu.    |
  1400.                +-< Delete Menu >+   +----< Report Menu >----+ |
  1401.                | Replace a disk |   | Volume report         | |
  1402.                | rEname a disk  |   | Quick volume report   | |
  1403.                | Delete a disk  |   | File/ext report       | |
  1404.                | Zap database   |   | quick file/Ext report | |
  1405.                +----------------+   | Duplicate files       | |
  1406.                                     | 43/50 line mode       | |
  1407.                                     +-----------------------+ |
  1408.                                                               |
  1409.                                                   Pressing ALT-O
  1410.                                                   selects the 
  1411.                                                   Option submenu.
  1412.                                            +----< Options >-----+
  1413.                                            | Catalog options    |
  1414.                                            | Printer options    |
  1415.                                            | color opTions      |
  1416.                                            | Logging drive(s)   |
  1417.                                            | Read new database  |
  1418.                                            | Write database     |
  1419.                                            | library Extensions |
  1420.                                            | Maximum files, etc |
  1421.                                            | lOad configuration |
  1422.                                            | Save configuration |
  1423.                                            | reset to Defaults  |
  1424.                                            +--------------------+
  1425.  
  1426.         22                                              LogiCat Users Guide
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.         Each  of  the various  submenus will  be  covered in  detail in  the
  1435.         following sections.
  1436.  
  1437.  
  1438.         Add Menu
  1439.  
  1440.         This section  of the manual explains the options that are located in
  1441.         the add  submenu.   This  is the  menu that  allows you  to add  new
  1442.         records to the  database and  add/modify comments  for the  database
  1443.         entries.
  1444.  
  1445.  
  1446.         Log Floppy Disks
  1447.  
  1448.         This menu option is used to scan a disk adding the file names  found
  1449.         to  the  current  database.   After  picking  this  option  you  are
  1450.         prompted to  insert a disk  in the logging  drive.  After  inserting
  1451.         the disk press  the enter key to tell  LogiCat to scan the disk.  If
  1452.         you  don't  have  the   options  set  in  a  way  that  LogiCat  can
  1453.         automatically name  the disk, you will  be asked for  the disk name.
  1454.         There  are two  ways that LogiCat  can automatically name  the disk.
  1455.         First, if you  have automatic disk naming  turned on, and second  if
  1456.         you  have LogiCat set to use  the volume name as the disk name (this
  1457.         causes automatic naming if the disk has a volume label). 
  1458.  
  1459.         After  LogiCat finishes scanning the disk you are prompted to insert
  1460.         the next disk.
  1461.  
  1462.         After you  finish logging  disks press the  ESCape key to  return to
  1463.         the add submenu.
  1464.  
  1465.  
  1466.         Dummy Entry
  1467.  
  1468.         This  option is  almost  like the  'Log floppy  disks' option.   The
  1469.         difference  is this  one creates a "dummy"  entry (volume name only)
  1470.         in  the database.  Using this option you can record the existence of
  1471.         a particular disk  when you don't  want to include  the file  names.
  1472.         One  good example  of this  would be  for logging  a master  program
  1473.         disk.   A  program disk  is likely  to contain  many various  files,
  1474.         however they are all related to the main program.
  1475.  
  1476.  
  1477.         Add/mod Comments
  1478.  
  1479.         This  option  allows  you  to  add/delete/modify  the  comments  and
  1480.         keywords for  each of the  entries in  the current database.   After
  1481.         choosing  this option  you will be asked  for the selection criteria
  1482.         and  sort options (if LogiCat is configured to ask for them).  Using
  1483.  
  1484.         LogiCat, Disk Cataloger                                          23
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.         the  selection criteria you  can limit the list  of files brought up
  1493.         to  those  desired  (see  the  section  titled  'Selecting  Specific
  1494.         Records' on page 18 for details on selection criteria).
  1495.  
  1496.         Next,  the comment  entry screen  is displayed  for the  first file.
  1497.         While  adding/modifying  the comments  and  keywords there  are  two
  1498.         basic modes.  The first,  is the view mode (this is the mode  you're
  1499.         in when  you first  choose  the add/mod  comments menu  item).   The
  1500.         second mode is the edit mode.
  1501.  
  1502.         In the view  mode you are  able to view  the keywords  and comments,
  1503.         but changes can't be made to them.   In view mode it is expected you
  1504.         will  page through the  files to find the one  you desire to change,
  1505.         and then enter edit mode.
  1506.  
  1507.         While you are in view mode the following commands  are available (as
  1508.         listed at the bottom of the screen):
  1509.  
  1510.           F1   Toggle edit mode.   Pressing the  F1 key while in  view mode
  1511.                puts you in  edit mode.  Pressing the F1 key while you're in
  1512.                edit mode puts you back in view mode.
  1513.  
  1514.           S    Search.  Pressing  the S key while  in view mode causes  the
  1515.                search window to pop-up and allow you to specify the data to
  1516.                search for.  This allows you to quickly find a desired  file
  1517.                or files.
  1518.  
  1519.           F2   Copy  comments to  scrap.   This copies  the  current file's
  1520.                comment to the scrap comment buffer.
  1521.  
  1522.           F3   Copy keywords  to scrap.    This copies  the current  file's
  1523.                keyword(s) to the scrap keyword buffer.
  1524.  
  1525.           F4   Delete comments.  Pressing F4 will delete the current file's
  1526.                comment.
  1527.  
  1528.           F5   Copy scrap  comments.    This copies  the  comment  that  is
  1529.                currently in  the scrap  buffer to  the file  that is  being
  1530.                displayed.    If  the  scrap buffer  comment  is  blank this
  1531.                command will delete the current file's comment.
  1532.  
  1533.           F6   Copy scrap keywords.  This copies the keyword(s) that are in
  1534.                the scrap buffer  to the file  that is currently  displayed.
  1535.                If the scrap  keyword buffer is  empty this will delete  the
  1536.                current file's keywords.
  1537.  
  1538.           F7   Delete keywords.  This deletes the current file's keywords.
  1539.  
  1540.  
  1541.  
  1542.         24                                              LogiCat Users Guide
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.           F8   Previous file (without  saving current).  Pressing  this key
  1551.                causes LogiCat to display the previous file.  Any changes to
  1552.                the current file are discarded  (after you confirm you  want
  1553.                to abort changes).
  1554.  
  1555.           F9   Next file  (without saving current).   This advances  to the
  1556.                next file.  Changes to the current file are discarded (after
  1557.                you confirm you want to abort changes).
  1558.  
  1559.           F10  Save and  advance.   This advances  to the  next file  after
  1560.                saving the changes to the current file.
  1561.  
  1562.           PgUp,PgDn, Up, Down  These commands move to the previous/next
  1563.                file after saving any changes that  were made to the current
  1564.                file.
  1565.  
  1566.         Once  you  press  F1 to  enter  edit  mode,  the  keyword  field  is
  1567.         highlighted,  and  the cursor  is placed  waiting for  you to  start
  1568.         editing the field.   While you're in the keywords field the standard
  1569.         LogiCat editing keys are active.
  1570.  
  1571.         In  edit mode  the list  of available  commands goes  from the  list
  1572.         above to the following:
  1573.  
  1574.           F1   Toggle edit mode.  Pressing F1 puts you back in view mode.
  1575.  
  1576.           F8   Previous file without saving current.
  1577.  
  1578.           F9   Next file without saving current.
  1579.  
  1580.           F10  Save current changes and advance to the next file.
  1581.  
  1582.         Beyond those commands you also have the editing commands  available.
  1583.         While  you're in  the keywords  field the  editing commands  are the
  1584.         standard  commands  provided  by LogiCat  (see  the  section  titled
  1585.         'Editing String Fields' on page  11 for a review of the editing keys
  1586.         available).
  1587.  
  1588.         When you press  the enter key (or the down arrow) you will be in the
  1589.         memo  field  to enter  comments  about the  file  that is  currently
  1590.         displayed.  While you're  editing the comment field  a whole new set
  1591.         of  editing commands are available.  The editing keys provided while
  1592.         in  the comment field are more suitable for  editing the large field
  1593.         (i.e. similar to a word processor with automatic word wrap).   There
  1594.         are  many similarities  between  the  keys  in the  LogiCat  comment
  1595.         editor and  the  Brief  editor.   The memo  editor  commands are  as
  1596.         follows:
  1597.  
  1598.  
  1599.  
  1600.         LogiCat, Disk Cataloger                                          25
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.           Backspace      Deletes the character  to the  left of the  cursor
  1609.                          and moves the cursor left  one position.  (This is
  1610.                          the classic PC action for the backspace key).
  1611.  
  1612.           Delete         Deletes the  character currently under  the cursor
  1613.                          (if mark mode is  off).  When mark mode  is turned
  1614.                          on pressing the delete key causes the marked block
  1615.                          to be deleted.
  1616.  
  1617.           Insert         Toggles insert mode on and off.
  1618.  
  1619.           Arrow Keys     Moves the cursor the direction of the arrow.
  1620.  
  1621.           Control Right  Moves right to the next word.
  1622.  
  1623.           Control Left   Moves left to the previous word.
  1624.  
  1625.           Control Space  Puts a "hard" space in the document.  This is used
  1626.                          to insure two words aren't  split by the automatic
  1627.                          word wrap.
  1628.  
  1629.           Home           Moves to the start of the current line.
  1630.  
  1631.           Home Home      (2  homes  in a  row) Moves  to  the start  of the
  1632.                          currently displayed window.   This is the  same in
  1633.                          effect as pressing Control Home.
  1634.  
  1635.           Home Home Home (3 homes in a row) Moves  to the start of the edit
  1636.                          buffer.   This is the  same in effect  as pressing
  1637.                          Control PgUp.
  1638.  
  1639.           End            Moves to the end of the current line
  1640.  
  1641.           End End        (2 ends in a row) Moves to  the end of the current
  1642.                          window.  This  is identical in effect  to pressing
  1643.                          Control End.
  1644.  
  1645.           End End End    (3  ends  in a  row) Moves  to  the bottom  of the
  1646.                          comment.  This is identical  in effect to pressing
  1647.                          Control PgDn.
  1648.  
  1649.           PgUp           Moves the screen up  by a page full (where  a page
  1650.                          is defined as the maximum amount  of data that can
  1651.                          be displayed in the edit window).
  1652.  
  1653.           PgDn           Moves the screen down by a page full.
  1654.  
  1655.           Control Home   Moves to the start of the currently displayed edit
  1656.                          window.
  1657.  
  1658.         26                                              LogiCat Users Guide
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.           Control End    Moves to the end of the currently displayed window
  1668.                          full of text.
  1669.  
  1670.           Control PgDn   Moves to the end of the edit buffer.
  1671.  
  1672.           Control PgUp   Moves to the top of the edit buffer.
  1673.  
  1674.           ALT C          Centers the current line of text.
  1675.  
  1676.           ALT D          Deletes the current line of text.
  1677.  
  1678.           ALT I          Inserts the contents of the editor scrap buffer at
  1679.                          the current cursor location.   Note that the scrap
  1680.                          buffer used here is particular  to the editor, and
  1681.                          has  nothing to do  with the comment/keyword scrap
  1682.                          buffers described in the view mode section.
  1683.  
  1684.           ALT K          Deletes from the cursor location to the end of the
  1685.                          cursor line.
  1686.  
  1687.           ALT L, ALT M   Toggles  mark mode  (allows  marking  a  block  of
  1688.                          text).
  1689.  
  1690.           Keypad Minus   If mark mode is off this  cuts the current line to
  1691.                          the scrap buffer.   If mark  mode is on this  cuts
  1692.                          the currently marked block to scrap.
  1693.  
  1694.           Keypad Plus    If mark mode  is off this copies  the current line
  1695.                          to the  scrap buffer.   If  mark mode  is on  this
  1696.                          copies the currently marked block to scrap.
  1697.  
  1698.           Control Y      Deletes the current line.   (Same in effect as ALT
  1699.                          D).
  1700.  
  1701.  
  1702.         Delete/replace Menu
  1703.  
  1704.         The delete/replace  menu is  where you should  go if  you desire  to
  1705.         delete,  replace, or rename a disk that's currently in the database.
  1706.         This  section goes  over  these  three options  as well  as  a forth
  1707.         option that allows you to ZAP the database.
  1708.  
  1709.  
  1710.         Replace a Disk
  1711.  
  1712.         You should use this  option when you need to  replace a disk that is
  1713.         already in the database.  This is needed if  you modify (i.e. add or
  1714.         delete  files)  a  disk that  was  already  cataloged.   Instead  of
  1715.  
  1716.         LogiCat, Disk Cataloger                                          27
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.         forcing you to delete the old disk and  then add a new one,  LogiCat
  1725.         allows  you to simply tell it you wish to  replace the disk; LogiCat
  1726.         will do the work for  you.  Now there's no  reason to avoid changing
  1727.         the contents of a disk once you've cataloged it!
  1728.  
  1729.         When you choose this option  LogiCat will prompt for the name of the
  1730.         disk  that is  being replaced.  After  you give LogiCat  the name it
  1731.         will do the rest.
  1732.  
  1733.  
  1734.         Rename a Disk
  1735.  
  1736.         This option  allows you to change the name of a disk  that is in the
  1737.         database.  You will be prompted for the existing  disk name (the old
  1738.         name) and then  you will be prompted for  the name that you want  to
  1739.         use.    The new  name  must  be a  name  that isn't  already  in the
  1740.         database.
  1741.  
  1742.  
  1743.         Delete a Disk
  1744.  
  1745.         This option allows you to delete a disk from  the database.  You are
  1746.         prompted for the name of the disk to be  deleted after choosing this
  1747.         option.
  1748.  
  1749.  
  1750.         Zap Database
  1751.  
  1752.         Choosing  this option zaps the entire database (deletes all disks in
  1753.         the database).  Because  of the potential for  massive data loss you
  1754.         will be asked if you are sure before LogiCat zaps the database.
  1755.  
  1756.  
  1757.         Search Menu
  1758.  
  1759.         The search menu allows you  to easily search for and find files with
  1760.         ease.   The  options in this menu  all relate to  browsing the files
  1761.         allowing you to search for a file based on any of the following:
  1762.  
  1763.           o File name
  1764.  
  1765.           o Disk name
  1766.  
  1767.           o Keywords
  1768.  
  1769.           o Comments
  1770.  
  1771.  
  1772.  
  1773.  
  1774.         28                                              LogiCat Users Guide
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.         Browse Files
  1783.  
  1784.         This  option allows  you to enter browse  mode without entering data
  1785.         to search for.   Unlike  the other  options on  the search  submenu,
  1786.         this option  is the only one that allows you to enter a complete set
  1787.         of  selection criteria as well as sort options (providing LogiCat is
  1788.         optioned to ask for the options).  
  1789.  
  1790.         Once  you're in  browse mode  there  are several  commands available
  1791.         (all  are listed on the  status line near the bottom of the screen).
  1792.         The commands  include keys  such as pgup,  pgdn, up  arrow, and  the
  1793.         down  arrow  for  "browsing"  through  the files  that  matched  the
  1794.         selection  criteria  (if  you specified  selection  criteria).    In
  1795.         addition you  can press the  letter 'S'  to cause LogiCat  to prompt
  1796.         you for search data.
  1797.  
  1798.         After  pressing  'S'  the  search window  is  displayed.    You  are
  1799.         prompted  to  enter  the  string to  search  for.   In  addition  to
  1800.         entering  the  search string  you  can change  any  of the  standard
  1801.         search options by using the  tab key to move to the option you  want
  1802.         to toggle, and then press the space bar to toggle the option.
  1803.  
  1804.         Note  that the  search data  you enter is  only checked  against the
  1805.         files that weren't excluded by selection criteria.
  1806.  
  1807.  
  1808.         String Search
  1809.  
  1810.         The string search is the  next option.  This is  just another way to
  1811.         enter the browse mode  that was discussed above.   The difference is
  1812.         that  unlike using the browse files menu option, this option doesn't
  1813.         give  you a  chance to specify  selection criteria or  sort options.
  1814.         Instead,  the search  window is displayed, and  you are prompted for
  1815.         the search data and options.
  1816.  
  1817.         When  you use  the string  search option  the search  window has the
  1818.         defaults  set to search ALL fields searching is allowed on.  You can
  1819.         manually override the fields to search by tabbing to  the option and
  1820.         toggling it's value with the space bar.
  1821.  
  1822.  
  1823.         Comment Search
  1824.  
  1825.         The  comment search  option is  just like  the string  search option
  1826.         except  at default the  options are set to  only search the comments
  1827.         for the data you type.  As with the string search, you can  override
  1828.         the fields to be searched by manually changing the options.
  1829.  
  1830.  
  1831.  
  1832.         LogiCat, Disk Cataloger                                          29
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.         Keyword Search
  1841.  
  1842.         The  keyword  search is  like  the other  search  options except  at
  1843.         default only the keyword field is searched for the data.
  1844.  
  1845.  
  1846.         File Search
  1847.  
  1848.         The file search is like the  other search options except  at default
  1849.         only the file name is searched for the data you enter.
  1850.  
  1851.  
  1852.         Case Sensitivity
  1853.  
  1854.         This option toggles the case sensitivity of  the searches in a  case
  1855.         sensitive   field  (the  filename  and  the  directory  aren't  case
  1856.         sensitive).  When  the case sensitivity flag  is turned off a  match
  1857.         isn't found  if there  is a difference  in case.   You can tell  the
  1858.         setting  of  this  option  by  looking  at  the menu  item  (OFF  is
  1859.         displayed next to this option  if it's OFF, and  ON is displayed  if
  1860.         it  is  on).   Note:    the case  sensitivity  flag setting  is also
  1861.         displayed on the main screen in the options window.
  1862.  
  1863.  
  1864.         Reports Menu
  1865.  
  1866.         The  reports menu  contains all  the menu  items to  choose  for the
  1867.         various types of reports available in LogiCat.
  1868.  
  1869.         Before  going into the various reports there are several features of
  1870.         the  reports that will be  overviewed.  One of the first things that
  1871.         you  may notice about  the reports is  the use  of the  printer name
  1872.         'SCREEN'.   Anytime the name  of the printer  is SCREEN the  printer
  1873.         path  (from the  options) is ignored  and the output  is directed to
  1874.         the  screen.  When  you send a  report to  the screen  you have some
  1875.         special  commands available at the  end of each  display page.  When
  1876.         you're at the  end of a  page of  output directed to the  screen the
  1877.         following commands are available:
  1878.  
  1879.           ESCape    Aborts  the  report  and  returns  you  to  the  report
  1880.                     submenu.
  1881.  
  1882.           S         Initiates a search.   If  the search data  you type  is
  1883.                     found  LogiCat automatically displays  the page of data
  1884.                     the  matching file is  on, and highlights  the match to
  1885.                     make it easy to pick out of the list.
  1886.  
  1887.           PgUp/Up arrow - Moves to the previous page of the report.
  1888.  
  1889.  
  1890.         30                                              LogiCat Users Guide
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.           Any other  key moves you to  the next page of the  report (if you
  1899.           were already on  the last page of the report you will be returned
  1900.           to the report menu).
  1901.  
  1902.         NOTE:  If  the fields you have  set to  print can cause a  record to
  1903.         occupy more than one line on the  report, LogiCat will not go  up by
  1904.         an exact page when you press the PgUp/Up arrow.
  1905.  
  1906.         You  can control  the fields  to print  along with  the size  of the
  1907.         printed  page  by  using the  Options  menu  to change  the  printer
  1908.         options.  Note that  the page setup doesn't effect output that  goes
  1909.         to the screen.
  1910.  
  1911.         One last note about the reports menu is  that when you select one of
  1912.         the  "quick"  reports  you  won't  be  prompted  for  sort  data  or
  1913.         selection  criteria regardless  of the LogiCat settings.   The quick
  1914.         reports automatically  sort  the  data in  a predefined  manner  (as
  1915.         noted in the discussion of the individual menu options).
  1916.  
  1917.  
  1918.         Volume Report
  1919.  
  1920.         The  volume report is a report that lists all  the disk volumes that
  1921.         are in the  database.   The individual files  aren't listed on  this
  1922.         report.   When  you select the volume  report you will  be asked for
  1923.         the  sort options  (providing LogiCat  is set  to  ask for  the sort
  1924.         options).  The following is an example of the volume report:
  1925.  
  1926.         Logicat Disk Volume Report  -  12:12 am   December 23, 1990   Pg 1  
  1927.            
  1928.         Disk Name    Used Space  Free Space  Total Space  Files  Indexed   
  1929.         ---------    ----------  ----------  -----------  -----  -------   
  1930.         LC000000001     222,208     140,288      362,496      0  12/22/89  
  1931.         LC000000002     197,632     164,864      362,496      1  12/22/89  
  1932.         LC000000003     240,640      81,920      322,560      2  12/22/89  
  1933.         LC000000004     361,472       1,024      362,496     13  12/22/89  
  1934.         LC000000005     196,608     165,888      362,496      6  12/22/89  
  1935.         LC000000006     351,232      11,264      362,496     74  12/22/89  
  1936.         LC000000007     360,448       2,048      362,496     22  12/22/89  
  1937.         LC000000008     353,280       9,216      362,496     39  12/22/89  
  1938.         LC000000009     220,160     142,336      362,496     31  12/22/89  
  1939.         LC000000010     230,400     132,096      362,496     12  12/22/89  
  1940.         LC000000011  23,439,360  10,004,480   33,443,840  1,104  12/22/89  
  1941.  
  1942.         Note  that  the comments  and keywords  are printed  for the  volume
  1943.         report if you  have the options set  to print comments and keywords.
  1944.         (See the discussion of the  Options Menu printer options  on page 39
  1945.         for details).
  1946.  
  1947.  
  1948.         LogiCat, Disk Cataloger                                          31
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.         Quick Volume Report
  1957.  
  1958.         The quick volume report is  identical to the volume  report with the
  1959.         exception that it automatically sorts the volumes by disk name.
  1960.  
  1961.  
  1962.         File/Ext Report
  1963.  
  1964.         The  file/ext report is a  report that lists  all the files that are
  1965.         in the  database.   When  you select  the  file/ext  report you  are
  1966.         prompted  for the  selection criteria  as well  as the  sort options
  1967.         (providing  LogiCat is set  to ask for the  options).  The following
  1968.         is an example of the file/ext report:
  1969.  
  1970.         Logicat File/Ext Listing Report  -  12:12 am  Dec 23, 1990   Pg 7   
  1971.  
  1972.          File Name   Disk Name      Size  Date      Time         Library
  1973.          ---------   ---------  --------  ----      ----         -------
  1974.          CATOPT.BAK  LC000000011   8,042  12/06/89  09:08:48 pm
  1975.          CATOPT.C    LC000000011   8,029  12/06/89  09:12:34 pm
  1976.         *CATOPT.C    LC000000011   6,015  09/11/89  08:21:42 pm
  1977.         *CATOPT.C    LC000000011   8,042  12/18/89  05:05:24 pm
  1978.                      This is the current version of the source
  1979.                      for the LogiCat Options Menu handler. All
  1980.                      of the options are handled in this module.
  1981.  
  1982.         *CATOPT.C    LC000000011   6,032  09/05/89  09:18:34 pm
  1983.          CATOPT.OBJ  LC000000011   7,901  12/18/89  05:08:02 pm
  1984.          CATOPT1.C   LC000000011   2,924  09/04/89  01:26:50 pm
  1985.         *CATOPT1.C   LC000000011   2,924  09/11/89  08:20:42 pm
  1986.         *CATOPT1.C   LC000000011   2,924  12/18/89  05:05:24 pm
  1987.          CB.EXE      LC000000011  37,322  09/15/89  03:00:00 pm
  1988.          CBERR.H     LC000000011   6,773  09/28/88  04:17:10 pm
  1989.          CBFIND.C    LC000000011   1,192  08/20/89  12:18:28 am
  1990.          CBKEYCMP.C  LC000000011  12,349  09/11/89  08:20:42 pm
  1991.         *CBKEYCMP.C  LC000000011  12,334  09/05/89  07:29:06 pm
  1992.          CBL.        LC000000011   2,026  08/07/89  06:23:32 pm
  1993.          CBL.BAK     LC000000011   2,065  08/07/89  06:28:00 pm
  1994.          CBL.CM      LC000000011   2,484  10/23/89  05:19:54 pm
  1995.          CBL.M       LC000000011   3,693  10/23/89  05:09:16 pm
  1996.         *CBL.M       LC000000011   3,732  10/23/89  05:19:50 pm
  1997.          CBL.OLD     LC000000011   1,338  05/01/89  02:00:34 pm
  1998.  
  1999.  
  2000.         Quick File/Ext Report
  2001.  
  2002.         The  quick file/ext  report  is  identical to  the  file/ext  report
  2003.         except  when  you  choose  the  quick  file/ext  report  you  aren't
  2004.  
  2005.  
  2006.         32                                              LogiCat Users Guide
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.         prompted  for the selection criteria or sort options.  The files are
  2015.         automatically sorted by file and extension.
  2016.  
  2017.  
  2018.         Duplicate Files
  2019.  
  2020.         This report  gives  you a  listing of  the files  that are  possible
  2021.         duplicates.   LogiCat  considers files to be  duplicates if the name
  2022.         and extensions  match.   Just because  you have  two files  with the
  2023.         same name  doesn't necessarily mean  you have  duplicate files,  but
  2024.         the  odds are  high identically  named  files will  turn out  to  be
  2025.         duplicates.   The duplicates report  looks identical to the file/ext
  2026.         report (the fields that are printed as well as the layout).
  2027.  
  2028.  
  2029.         43/50 Line Mode
  2030.  
  2031.         This option  toggles the use of  43/50 line output for reports going
  2032.         to the  screen.  Note that you  can only turn  this option on if you
  2033.         have an EGA/VGA or equivalent adapter.
  2034.  
  2035.         Options Menu
  2036.  
  2037.         The options submenu has all  the items that allow  you to change the
  2038.         settings  in LogiCat.  This  section of the  manual explains each of
  2039.         the menu items available via the options submenu.
  2040.  
  2041.  
  2042.         Catalog Options
  2043.  
  2044.         This menu  choice allows  you to  set most  of the  LogiCat options.
  2045.         The options you can set by choosing Catalog  Options are the options
  2046.         on  the  main  screen in  the  windows  titled 'Volume  Labels'  and
  2047.         'Catalog  Options'.   When you choose the  catalog options menu item
  2048.         the first field  on the screen is highlighted, and the bottom status
  2049.         line changes to list the commands available.
  2050.  
  2051.         You should use the arrow keys to move the highlight bar  to the item
  2052.         that  you wish  to  change.   Once the  item you  want to  change is
  2053.         highlighted  press the  enter key to change  the item.   (Note:  the
  2054.         items  that have  Yes/No values  are toggled  by pressing  the enter
  2055.         key).
  2056.  
  2057.         The following describes each of the options available:
  2058.  
  2059.           1)   Use disk name  as label?   This option specifies whether  or
  2060.                not LogiCat  should write  the disk name  to the  disk as  a
  2061.                volume label.   If you set this option to 'Yes' LogiCat will
  2062.                automatically create a  volume label on  the disk using  the
  2063.  
  2064.         LogiCat, Disk Cataloger                                          33
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.                disk  name  (if a  volume label  already  exists it  will be
  2073.                deleted first).   Note  that the  volume name  creation will
  2074.                fail if you specify a disk name that doesn't obey the  rules
  2075.                for naming a volume (as  explained in your DOS manual).   At
  2076.                default this option is set to 'No'.
  2077.  
  2078.           2)   Delete existing label?  This option specifies whether or not
  2079.                LogiCat should  automatically delete existing  volume labels
  2080.                as it logs disks.  At default this option is set to 'No'.
  2081.  
  2082.           3)   Use existing label  as name?  This  option specifies whether
  2083.                or not LogiCat should treat an existing disk volume label as
  2084.                the disk  name.  If  you set  this option  to 'Yes'  LogiCat
  2085.                automatically names  disks that have  a volume label.   This
  2086.                has precedence over automatic disk naming using the template
  2087.                (described next).  At default this option is set to 'No'.
  2088.  
  2089.           4)   Automatic disk naming?  This option specifies whether or not
  2090.                LogiCat  should  automatically  name  the  disks  using  the
  2091.                template name.   When  automatic disk  naming is  on LogiCat
  2092.                will use the  template to  generate a unique  name for  each
  2093.                disk as it's logged.  The  method LogiCat uses to generate a
  2094.                name is by sequentially increasing the last name used (using
  2095.                the template) until a unique name is generated.  Examples of
  2096.                this will be provided in the description of the template and
  2097.                last  name used  option.  At  default this option  is set to
  2098.                'No'.
  2099.  
  2100.           5)   Template.  This is the  template that is used to generate  a
  2101.                disk name  when  you are  using automatic  disk naming  (the
  2102.                option explained above).  The template should be composed of
  2103.                Xs and 9s.  The X  character is essentially a place  holder,
  2104.                and  the  9  character  is  a  character  that  LogiCat  can
  2105.                sequentially increment.  For example, consider the following
  2106.                template:
  2107.  
  2108.                     XX999     This template specifies a template for a five
  2109.                               character name.    The  first  two  positions
  2110.                               represent  characters  that  are  fixed  (not
  2111.                               changed by LogiCat when it generates a name).
  2112.                               The  last  three positions  represent numeric
  2113.                               characters  that  are  subject to  change  by
  2114.                               LogiCat when a name is generated.
  2115.  
  2116.                At default this option is set to:  XX999999999.
  2117.  
  2118.           6)   Last.   This is the name of the  last disk that was added to
  2119.                the database  by automatic naming.  The name here is used in
  2120.                conjunction with  the template described above.   To see how
  2121.  
  2122.         34                                              LogiCat Users Guide
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.                it works consider  the following examples to see how LogiCat
  2131.                would generate a disk name:
  2132.  
  2133.                     Template       Last      Generated Name      Disk
  2134.                     --------       ----      --------------      ----
  2135.                     XX999          LC000     LC001               1st
  2136.                                    LC001     LC002               2nd
  2137.                                    ...
  2138.                                    LC099     LC100               100th
  2139.  
  2140.                     X9XX9          L0DB0     L0DB1               1st
  2141.                                    L0DB1     L0DB2               2nd
  2142.                                    L0DB9     L1DB0               10th
  2143.  
  2144.                If LogiCat  is unable  to generate  a unique  name an  error
  2145.                message will be displayed, and you will be prompted to enter
  2146.                the disk name  manually.  At default this option  is set to:
  2147.                LC000000000.
  2148.  
  2149.           7)   Keep subdir  names?   This option  specifies whether  or not
  2150.                LogiCat should collect  subdirectory names.  If  this option
  2151.                is set to 'Yes' LogiCat tracks  the directory names that the
  2152.                files are found in.  At default this option is set to 'Yes'.
  2153.  
  2154.           8)   Backup  database?    This option  specifies  whether  or not
  2155.                LogiCat should backup a database before  opening it.  As was
  2156.                already discussed,  LogiCat keeps  the changes  to the  main
  2157.                database resident in  memory until you specify to write them
  2158.                or exit the program.   However, the comments are implemented
  2159.                in a disk based database  that changes as modifications  are
  2160.                made to the comments.  If backups are turned on LogiCat will
  2161.                copy the  contents of the main database and comment database
  2162.                to .BAK files  if a change was  made.  For instance,  if you
  2163.                are using LC.DB (the default database):
  2164.  
  2165.                     Physical Databases       Backup Databases
  2166.                     -------------------      ----------------
  2167.                     LC.DB                    LC.BAK
  2168.                     LC1.DB                   LC1.BAK
  2169.  
  2170.                (Remember from the  introduction to how LogiCat  stores data
  2171.                that the comments  are stored  in a database  with the  same
  2172.                name as the  main database, with a '1' appended.  That's why
  2173.                database  names can  only  be seven  characters  long).   At
  2174.                default this option is set to 'No'.
  2175.  
  2176.           9)   Extract  library members?    This  option specifies  whether
  2177.                LogiCat should look  inside ARChives to determine  the names
  2178.                of the files contained  in the archives.  When you have this
  2179.  
  2180.         LogiCat, Disk Cataloger                                          35
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.                option set to 'Yes', LogiCat adds the names of all the files
  2189.                inside the archive to the database (flagging them as members
  2190.                of the archive).  LogiCat is capable of viewing files in the
  2191.                following formats:
  2192.  
  2193.                     LHARC
  2194.                     ZIP
  2195.                     ARC
  2196.                     PAK
  2197.                     ZOO
  2198.  
  2199.                LogiCat only  checks to see if a file  is an archive if it's
  2200.                extension   matches  one   of  the  extensions   LogiCat  is
  2201.                configured  to  check.    See   the  discussion  on  ARChive
  2202.                extensions on page 41  for details.  At default  this option
  2203.                is set to 'No'.
  2204.  
  2205.           10)  Extract library comments?  This  option specifies whether or
  2206.                not LogiCat should attempt to pull comments out of archives.
  2207.                LogiCat is  capable of  extracting the  comments out  of all
  2208.                supported formats that allow comments in the  archive.  This
  2209.                allows you to add  comments to files without having  to type
  2210.                them, by using  the comments contained  in the archive.   At
  2211.                default this option is set to 'No'.
  2212.  
  2213.           11)  Flag duplicate records?   This  option specifies whether  or
  2214.                not LogiCat should flag "duplicate"  records on the reports.
  2215.                When you set  this option to 'Yes' LogiCat will  display a *
  2216.                beside  entries  that appear  to  be  duplicates.   The  way
  2217.                records  are sorted (and  the report layout)  affect the way
  2218.                LogiCat finds duplicate records.  LogiCat considers a record
  2219.                to be a duplicate if the  first field on the report  matches
  2220.                that of the previous record.  The following is a sample of a
  2221.                report with duplicate flagging turned off,  and then with it
  2222.                on:
  2223.  
  2224.                With Flag duplicate records set to no:
  2225.  
  2226.         Logicat File/Ext Listing Report  -  12:12 am  Dec 23, 1990   Pg 7
  2227.          File Name   Disk Name      Size  Date      Time         Library
  2228.          ---------   ---------  --------  ----      ----         -------
  2229.          CATOPT.BAK  LC000000011   8,042  12/06/89  09:08:48 pm
  2230.          CATOPT.C    LC000000011   8,029  12/06/89  09:12:34 pm
  2231.          CATOPT.C    LC000000011   6,015  09/11/89  08:21:42 pm
  2232.          CATOPT.C    LC000000011   8,042  12/18/89  05:05:24 pm
  2233.          CATOPT.C    LC000000011   6,032  09/05/89  09:18:34 pm
  2234.          CATOPT.OBJ  LC000000011   7,901  12/18/89  05:08:02 pm
  2235.          CATOPT1.C   LC000000011   2,924  09/04/89  01:26:50 pm
  2236.          CATOPT1.C   LC000000011   2,924  09/11/89  08:20:42 pm
  2237.  
  2238.         36                                              LogiCat Users Guide
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.          CATOPT1.C   LC000000011   2,924  12/18/89  05:05:24 pm
  2247.          CB.EXE      LC000000011  37,322  09/15/89  03:00:00 pm
  2248.  
  2249.  
  2250.                With Flag duplicate records set to yes:
  2251.  
  2252.         Logicat File/Ext Listing Report  -  12:12 am  Dec 23, 1990   Pg 7
  2253.          File Name   Disk Name      Size  Date      Time         Library
  2254.          ---------   ---------  --------  ----      ----         -------
  2255.          CATOPT.BAK  LC000000011   8,042  12/06/89  09:08:48 pm
  2256.          CATOPT.C    LC000000011   8,029  12/06/89  09:12:34 pm
  2257.         *CATOPT.C    LC000000011   6,015  09/11/89  08:21:42 pm
  2258.         *CATOPT.C    LC000000011   8,042  12/18/89  05:05:24 pm
  2259.         *CATOPT.C    LC000000011   6,032  09/05/89  09:18:34 pm
  2260.          CATOPT.OBJ  LC000000011   7,901  12/18/89  05:08:02 pm
  2261.          CATOPT1.C   LC000000011   2,924  09/04/89  01:26:50 pm
  2262.         *CATOPT1.C   LC000000011   2,924  09/11/89  08:20:42 pm
  2263.         *CATOPT1.C   LC000000011   2,924  12/18/89  05:05:24 pm
  2264.          CB.EXE      LC000000011  37,322  09/15/89  03:00:00 pm
  2265.  
  2266.                At default this option is set to 'Yes'.
  2267.  
  2268.           12)  Memory for DOS shell.   This option is the amount  of memory
  2269.                that you  want to make  available for the  DOS Shell.   Note
  2270.                that  LogiCat  uses Switch!  to allow  you  to free  as much
  2271.                memory  as you  like for the  DOS shell.   Thanks to Switch!
  2272.                LogiCat is capable  of freeing virtually all memory  that is
  2273.                used by LogiCat making the memory free for the DOS shell.
  2274.  
  2275.                Switch! saves the  memory used by  LogiCat to EMS if  enough
  2276.                EMS  memory  is  available,  otherwise  the memory  used  by
  2277.                LogiCat is saved  to a disk file.  If you don't want LogiCat
  2278.                to  use  Switch!  specify  the  amount  of  memory  to  make
  2279.                available for the  shell as 0K.   At default this option  is
  2280.                set to 256.
  2281.  
  2282.                Remember that  the  DOS  shell can  be  invoked  *any*  time
  2283.                LogiCat is  waiting for  a keystroke  by pressing  the ALT-Z
  2284.                key.
  2285.  
  2286.           13)  Ask for select criteria?   This option specifies whether  or
  2287.                not LogiCat should  prompt for  the selection criteria  when
  2288.                you  choose  a  menu  item  that  allows  selecting  special
  2289.                records.  The  following menu items allow  selecting special
  2290.                records:
  2291.  
  2292.                     o    Add/mod comments
  2293.  
  2294.                     o    Browse files
  2295.  
  2296.         LogiCat, Disk Cataloger                                          37
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.                     o    File/ext report
  2306.  
  2307.                     o    Duplicate files
  2308.  
  2309.                At default this option is set to 'Yes'.
  2310.  
  2311.           14)  Ask for sort criteria?  This option specifies whether or not
  2312.                LogiCat should prompt for the sort  options.  If this option
  2313.                is  turned  off LogiCat  will  never  ask you  for  the sort
  2314.                options.  When this  option is turned on the  following menu
  2315.                items cause LogiCat to prompt for the sort items:
  2316.  
  2317.                     o    Add/mod comments
  2318.  
  2319.                     o    Browse files
  2320.  
  2321.                     o    Volume report
  2322.  
  2323.                     o    File/ext report
  2324.  
  2325.                     o    Duplicate files
  2326.  
  2327.                At default this option is set to 'Yes'.
  2328.  
  2329.           15)  Case sensitive search?  This option is the  case sensitivity
  2330.                flag.  When case  sensitivity is on LogiCat doesn't  match a
  2331.                string being searched  for unless the string and case match.
  2332.                If you  turn  on the  case flag  Hello is  considered to  be
  2333.                different than  hello.   At default  this option  is set  to
  2334.                'Yes'.
  2335.  
  2336.           16)  Printer name.   This  option is  where you  can specify  the
  2337.                printer name to LogiCat.  The name  SCREEN is a special case
  2338.                of the  printer name.   If you specify  the printer  name as
  2339.                SCREEN the report will go to the screen instead of the  path
  2340.                that is specified (the printer path is the next option to be
  2341.                discussed).
  2342.  
  2343.                Any other  printer name causes LogiCat to  use the specified
  2344.                printer path.  In the future LogiCat may have a  database of
  2345.                printers, and  use the  printer name  to locate  the control
  2346.                codes that allow LogiCat to take  advantage of the printer's
  2347.                capabilities for custom reports.  At default this  option is
  2348.                set to: SCREEN.
  2349.  
  2350.           17)  Report Dest.  This option is  the path of the printer.   The
  2351.                report destination is where the output of the report is sent
  2352.  
  2353.  
  2354.         38                                              LogiCat Users Guide
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.                (unless the printer  name is SCREEN).   You can specify  any
  2363.                DOS device/file for the report output.  For example:
  2364.  
  2365.                     Printer path             Sends output to
  2366.                     ------------             ---------------
  2367.                     LPT1                     First parallel port.  Normally
  2368.                                              this   is   where   your  real
  2369.                                              printer is.
  2370.  
  2371.                     COM1                     First COM port.  This is where
  2372.                                              a serial printer or a modem is
  2373.                                              attached.
  2374.  
  2375.                     C:\TEST.PRN              This  specifies  to  send  the
  2376.                                              output to  a file in  the root
  2377.                                              directory of  drive C:  called
  2378.                                              TEST.PRN.
  2379.  
  2380.                At default this option is set to: PRN.
  2381.  
  2382.  
  2383.         Printer Options
  2384.  
  2385.         The  printer options  item  allows you  to change  the fields  to be
  2386.         printed as well as the  page setup information.  After choosing this
  2387.         menu  item  you will  be  in  a  multi-field  input  mode where  the
  2388.         following options can be changed:
  2389.  
  2390.           Left margin    This  is  the  left  margin   of  the  report  (in
  2391.                          character spaces).  At default  this option is set
  2392.                          to 5.
  2393.  
  2394.           Right margin   This  is  the  right  margin  of  the  report  (in
  2395.                          character spaces).  At default  this option is set
  2396.                          to 78.   Note that the  right margin must be  less
  2397.                          than or equal to the  actual physical right margin
  2398.                          on the printer.
  2399.  
  2400.           Top margin     This is the number of lines to leave blank for the
  2401.                          top margin.  At default this value is 2.
  2402.  
  2403.           Bottom margin  This is the number of lines to leave blank for the
  2404.                          bottom margin.  At default this value is 1.
  2405.  
  2406.           FormFeed ok    This option  specifies whether  or not  a formfeed
  2407.                          character  is  allowed by  the  printer.   If this
  2408.                          option  is  set  to  'Yes'  LogiCat  will  send  a
  2409.                          formfeed to advance to the next  page.  If you set
  2410.                          this option to  'No' LogiCat prints line  feeds to
  2411.  
  2412.         LogiCat, Disk Cataloger                                          39
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.                          advance to the next page.  At default this item is
  2421.                          'Yes'.
  2422.  
  2423.           Action for a new line:  This option specifies what character or 
  2424.                          character sequence is needed  to advance the print
  2425.                          head  to  the  next  line   (at  the  start  print
  2426.                          position).  The possible values are:  CR (carriage
  2427.                          return), LF (linefeed), or  CRLF (both a  carriage
  2428.                          return and a linefeed).  At default this option is
  2429.                          set to CRLF.
  2430.  
  2431.           Lines per page This option specifies how many  lines there are on
  2432.                          the page.  At  default this option has a  value of
  2433.                          60 (which works properly on  LaserJet printers and
  2434.                          dot matrix  printers if  you FormFeed  OK is  on).
  2435.                          Note that  the default  value leaves  a few  extra
  2436.                          unused lines  on the bottom  of a dot  matrix page
  2437.                          which  can generally hold  upto 66 lines.   If you
  2438.                          don't have a  LaserJet you may wish to change this
  2439.                          option.  (Note:  Specifying zero causes the output
  2440.                          to be continuous).
  2441.  
  2442.           Pause at the end of a page:  This option allows you to use
  2443.                          LogiCat with a  single sheet printer.   If you set
  2444.                          this option to  'Yes' LogiCat  will prompt you  to
  2445.                          press a  key  after  each  page is  printed.    At
  2446.                          default this option is set to 'No'.
  2447.  
  2448.         The next  items on  the printer options  input allow you  to specify
  2449.         which fields  to print on  the report.   The values you  specify for
  2450.         the  fields  to  print don't  effect  the  Volume report  (with  the
  2451.         exception  of the keywords and  comments fields).  Since the various
  2452.         fields should be self explanatory they won't be gone over in  detail
  2453.         here.    You should  be aware  that  the order  selected fields  are
  2454.         printed  in is fixed.   All fields  that you  wish to  print will be
  2455.         printed in  the order  the  field  names are  shown on  the  printer
  2456.         options  input window.  Briefly, if you set all fields to be printed
  2457.         they would be printed in the following order:
  2458.  
  2459.           File name, subdirectory, disk name, file size, modification date,
  2460.           modification time, library name, keywords, and comments.
  2461.  
  2462.         The  last option on the  printer options window specifies whether or
  2463.         not you  want long lines  truncated.  If  you specify 'Yes'  LogiCat
  2464.         chops off all fields after  the right margin has  been hit (with the
  2465.         exception  of keywords and comments which are  printed beginning the
  2466.         second line).  At default lines aren't truncated.
  2467.  
  2468.  
  2469.  
  2470.         40                                              LogiCat Users Guide
  2471.  
  2472.  
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.         Color Options
  2480.  
  2481.         The  color options item allows  you to change the colors used by the
  2482.         LogiCat  disk cataloger.  When  you pick this item  you are prompted
  2483.         via menus for the colors to change.
  2484.  
  2485.  
  2486.         Logging Drive(s)
  2487.  
  2488.         Choosing  this  menu item  allows you  to change  the drive(s)  that
  2489.         LogiCat  uses  for logging  disks.   If  you  specify two  different
  2490.         drives LogiCat alternates between them for logging the disks.
  2491.  
  2492.  
  2493.         Read New Database
  2494.  
  2495.         This  option allows  you to  read a  new database  into memory.   If
  2496.         there were  any changes  made to  the database  that was already  in
  2497.         memory the changes will be saved before reading the new database.
  2498.  
  2499.         NOTE:  The extension is forced to .DB, all other specifications  are
  2500.         ignored.
  2501.  
  2502.  
  2503.         Write Database
  2504.  
  2505.         This option  writes the  current database to  disk.   If no  changes
  2506.         were made  since the  last time the  database was written  a message
  2507.         will be displayed.
  2508.  
  2509.  
  2510.         Library Extensions
  2511.  
  2512.         Choosing this option  allows you to edit the list of extensions that
  2513.         LogiCat  considers to be archives.   If you  have the options set to
  2514.         extract  archive contents, or  extract archive comments LogiCat will
  2515.         attempt to look  inside all files  it scans that  have an  extension
  2516.         listed  in the list of library extensions.  The following extensions
  2517.         are used at default:
  2518.  
  2519.                ZIP       ARC
  2520.                LZH       ZOO
  2521.                PAK       PKA
  2522.  
  2523.  
  2524.         Maximum Files Etc.
  2525.  
  2526.  
  2527.  
  2528.         LogiCat, Disk Cataloger                                          41
  2529.  
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.         This  option  allows you  to  change the  maximum  number of  files,
  2537.         disks,  and subdirectories  LogiCat can  handle.   The  greater  the
  2538.         maximum  for  each  of  these, the  greater  the  amount  of  memory
  2539.         required  is.   If there isn't enough  memory currently available to
  2540.         change to the specified amount you are given the  option to save the
  2541.         amount in a configuration file.   Note that if you exceed the amount
  2542.         that  can  be allocated  at  program startup  it  will take  LogiCat
  2543.         longer  to  initialize since  it will  have to  adjust memory  usage
  2544.         during initialization.
  2545.  
  2546.         You should be  aware that each  disk you configure  will use  one of
  2547.         the file slots  as well (the  file slot is  where the  disk name  is
  2548.         held).  So, if you ask  for 3000 files and 300  disks you will  only
  2549.         be able to use 2700 of the file slots for actual files.
  2550.  
  2551.         At  default there  are 3000  files, 300 disks,  and 300 dirs.   Note
  2552.         that   if  LogiCat   runs  out  of   memory  and  all   the  allowed
  2553.         files/disks/dirs  aren't  in use  LogiCat  will adjust  the  amounts
  2554.         allocated to  overcome the memory  shortage (a  message window  will
  2555.         inform you memory allocation was adjusted).
  2556.  
  2557.  
  2558.         Load Configuration
  2559.  
  2560.         This option  allows you  to  load  a new  configuration file.    You
  2561.         should   note  that  if  the  maximum  number  of  files,  disks  or
  2562.         directories is  less than the number that are already  in memory (or
  2563.         if  LogiCat  can't rearrange  the memory  settings due  to a  memory
  2564.         shortage),  a warning  will be issued, and  the maximum numbers will
  2565.         be left as they  were before you loaded  the configuration file (all
  2566.         other options will be set as indicated in the configuration file).
  2567.  
  2568.  
  2569.         Save Configuration
  2570.  
  2571.         This option allows you to  save the current configuration to a file.
  2572.         When  you pick this  option you  will be  asked for the  name of the
  2573.         file to save the configuration to.
  2574.  
  2575.  
  2576.         Reset to Defaults
  2577.  
  2578.         Picking  this  option causes  LogiCat to  reset the  options to  the
  2579.         default  values.   Note that this doesn't  change the maximum number
  2580.         of files, disks, or directories.
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.         42                                              LogiCat Users Guide
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.         Utilities Menu
  2595.  
  2596.         The utilities  menu contains the  utility type functions.  Currently
  2597.         there  are  only  two options  on  the  Utilities submenu:    Import
  2598.         comments  and  DOS Shell.   There  are many  more utility  functions
  2599.         planned.   New utility functions  will be added  to the menu as they
  2600.         are  created.   This  section of  the manual  documents the  options
  2601.         available on the utilities menu.
  2602.  
  2603.  
  2604.         Import Comments
  2605.  
  2606.         This option allows  you to import comments  from an ASCII text file.
  2607.         This  provides  a convenient  way to  add comments  to the  database
  2608.         without   having  to  manually  type  them.    Now  you  can  easily
  2609.         incorporate the descriptions from BBS listings into the database.
  2610.  
  2611.         Listings to  be imported must meet several conditions in order to be
  2612.         imported.  The following conditions must be met:
  2613.  
  2614.           o    The  listing must  be in  columnar form.   That is  the file
  2615.                names must always start in the  same column, and the comment
  2616.                field must always start in the same column.
  2617.  
  2618.           o    For multi-line comments, the comments must remain in an even
  2619.                column.  PCBoard and Auntie are two BBS systems that produce
  2620.                listings with  multiline comments  that will  work with  the
  2621.                import comment routine.  For example:
  2622.  
  2623.                     TEST.ARC    12212   12-12-89  This is an  example of  a
  2624.                                                   multi-line  comment  that
  2625.                                                   can   be    imported   by
  2626.                                                   LogiCat without problems.
  2627.  
  2628.                     TEST.ARC     12212    12-12-89 This is an example  of a
  2629.                     multi-line comment that can't be imported by LogiCat.
  2630.  
  2631.                The  first example  can  be imported  by  LogiCat while  the
  2632.                second  example can't.    RBBS produces  multi-line listings
  2633.                that can't be imported by LogiCat.
  2634.  
  2635.           o    Tab size  is assumed  to be  eight characters  (this is  the
  2636.                usual case for editors).
  2637.  
  2638.         When  you  choose  the  import   option  the  following   screen  is
  2639.         displayed:
  2640.  
  2641.  
  2642.  
  2643.  
  2644.         LogiCat, Disk Cataloger                                          43
  2645.  
  2646.  
  2647.  
  2648.  
  2649.  
  2650.  
  2651.  
  2652.  
  2653.         + Import Comments ---------------------------------------------------+
  2654.         |                                                                    |
  2655.         |               Comment setup file:  C:\LC.IMP                       |
  2656.         |                                                                    |
  2657.         | File with the comments to import:  C:\LOSTATC.DIR                  |
  2658.         |                                                                    |
  2659.         |         LogiCat database to use:  C:\LC.DB                         |
  2660.         |                                                                    |
  2661.         |        Starting column of file name:  1     end column  12         |
  2662.         |                                                                    |
  2663.         |          Starting column of comment:   32   end column  65         |
  2664.         |                                                                    |
  2665.         | Replace existing comments (Y/N/Ask):  Ask first                    |
  2666.         |                         PgUp/PgDn:  Change windows,  F10:  Proceed |
  2667.         +- Sample comment file text -----------------------------------------+
  2668.         |        1 |       2         3 |       4         5         6    |    7
  2669.         123456789.123456789.123456789.123456789.123456789.123456789.123456789.
  2670.         LC10   ZIP  189110 12-26-89 DS LogiCat V1.0 is the premiere of the 
  2671.                                        *best* cataloger available.  Has
  2672.                                        powerful features including multi-
  2673.                                        line comments, auto disk naming,
  2674.                                        and *many* other unique features!
  2675.         123456789.123456789.123456789.123456789.123456789.123456789.123456789.
  2676.         ^        1 ^       2         3 ^       4         5         6    ^    7
  2677.         |          |                   |                                |
  2678.  
  2679.         The cursor  is positioned  asking you for  the name  of the  comment
  2680.         setup file.  If this  file exists the rest of  the settings are read
  2681.         in (so as to default to the last values  used).  If the file doesn't
  2682.         exist LogiCat  will ask  if it is  ok to  create the file.   If  you
  2683.         answer 'Yes' the file will  be created when you  exit (if you  abort
  2684.         out   before  importing   the  comments  the   settings  file  isn't
  2685.         created/modified).
  2686.  
  2687.         The fields that are available are as follows:
  2688.  
  2689.           o    Comment setup file.   This is the  name of the file  that is
  2690.                used to hold the defaults  for importing comments.   LogiCat
  2691.                allows you to have multiple setup files (i.e. you could have
  2692.                one with the defaults set properly  for each type of listing
  2693.                you import).   In addition, LogiCat automatically  saves any
  2694.                changes made to the settings if  you don't abort out of  the
  2695.                import utility.
  2696.  
  2697.           o    File with the comments  to import.  This is the  name of the
  2698.                file that contains  the comments  you want to  import.   You
  2699.                have to enter the name of an existing file here to  get past
  2700.                this field.   As soon as you  enter the name of  an existing
  2701.  
  2702.         44                                              LogiCat Users Guide
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.                file the bottom  of the screen is  filled in with the  ruler
  2711.                lines.  Part of the file will be displayed between the ruler
  2712.                lines.
  2713.  
  2714.                Note:  You  can scroll  through the file  to be imported  by
  2715.                pressing the  PgUp or  PgDn keys  to switch  windows to  the
  2716.                bottom window.  Once you go to the bottom window you can use
  2717.                the up and down arrow keys to scroll through the file.  This
  2718.                method of scrolling is  slow, but is handy when  you need to
  2719.                do so.   Pressing  PgUp or  PgDn returns  you  to enter  the
  2720.                fields for the import settings.
  2721.  
  2722.           o    LogiCat  database  to  use.    This   is  a  field  that  is
  2723.                automatically  populated  with  the  name   of  the  current
  2724.                database to remind  you where the comments  will be imported
  2725.                to.  You can  only import comments to  the database that  is
  2726.                currently being used.
  2727.  
  2728.           o    Start and  end columns of the file.   These two fields allow
  2729.                you  to define where in  the file listing  the file name is.
  2730.                LogiCat can  handle names  with the  extension separated  by
  2731.                spaces or a single period.  Note that these two types can be
  2732.                intermixed without  problems.  As  you adjust the  start and
  2733.                end  columns the arrows on the  ruler lines move to show you
  2734.                where the file  name is expected to  be.  The start  MUST be
  2735.                before the end value or LogiCat will issue an error message.
  2736.  
  2737.           o    Start and end  columns of  the comments.   These two  fields
  2738.                allow you to define where in the file listing the comment is
  2739.                located.  As you adjust the values, the arrows on the status
  2740.                line  move to show where the comment field is expected.  The
  2741.                start column MUST be  before the end column or  LogiCat will
  2742.                issue an error message.
  2743.  
  2744.           o    Replace existing comments?  This field can have one of three
  2745.                values  (each selected by  pressing the first  letter of the
  2746.                desired value).  The values allowed are:
  2747.  
  2748.                     Yes  -  If  you  set this  value  LogiCat  will replace
  2749.                          existing  comments  without  asking  first.   This
  2750.                          means that if  a comment in the  listing conflicts
  2751.                          with an existing comment LogiCat  will discard the
  2752.                          existing comment and replace  it with the  comment
  2753.                          from the file listing.
  2754.  
  2755.                     No   -  If you set this  value LogiCat will not replace
  2756.                          any existing comments.  This  means that if a file
  2757.                          in  LogiCat  already has  a  comment LogiCat  will
  2758.                          discard the comment from the listing.
  2759.  
  2760.         LogiCat, Disk Cataloger                                          45
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.                     Ask  - LogiCat will prompt when it finds a comment that
  2770.                          conflicts with an  existing one.  This  allows you
  2771.                          to  choose  whether  or  not  to replace  the  old
  2772.                          comment on a one by one basis.
  2773.  
  2774.         When you're  ready to  import the  comments press the  F10 key,  and
  2775.         LogiCat will start importing the comments.
  2776.  
  2777.  
  2778.         DOS Shell
  2779.  
  2780.         This menu  item allows you to shell to DOS.  Note  that you can also
  2781.         use ALT-Z to shell to DOS from *anywhere* in  the program LogiCat is
  2782.         waiting for an input key.
  2783.  
  2784.  
  2785.         Quit Menu
  2786.  
  2787.         This isn't really much of a  menu, but is a second  way to quit  out
  2788.         of the program.  After  selecting the Quit menu you can press return
  2789.         (as  prompted)  to exit  the  program.   Note  that pressing  ESCape
  2790.         enough times will get you out of the program as well.
  2791.  
  2792.  
  2793.  
  2794.  
  2795.  
  2796.  
  2797.  
  2798.  
  2799.  
  2800.  
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.  
  2817.  
  2818.         46                                              LogiCat Users Guide
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.                                                                       Index
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.  
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.         LogiCat, Disk Cataloger                                          47
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.      43/50  line mode   3,  4, 22,      quit menu  4, 46
  2885.                33                       read  1, 4, 5, 10, 11, 16, 22,
  2886.      add menu  3, 9, 22, 23                       41, 44
  2887.      add/mod comments  3, 17,  18,      regular expressions  3, 4, 11,
  2888.                22, 23, 24, 37, 38                 13, 14-16, 20
  2889.      browse files  3,  17, 18, 22,      rename a disk  3, 22, 27, 28
  2890.                29, 37, 38               replace a disk  3, 22, 27
  2891.      case sensitivity  3, 22,  30,      reports menu  3, 10, 30, 31
  2892.                38                       reset to defaults  4, 22, 42
  2893.      catalog  options    4, 7,  8,      save  4, 8, 10, 11, 22, 25, 42
  2894.                22, 33                   search menu  3, 22, 28
  2895.      color options  4, 22, 41           searching  3, 4, 13, 16, 29
  2896.      commands  4, 11, 12,  24, 25,      setup  3, 6, 31, 39, 44
  2897.                29, 30, 33               string search  3, 22, 29
  2898.      comment search  3, 22, 29          tutorial  3, 5, 6, 9, 11
  2899.      comments    3, 4,  7,  8, 11,      utilities menu  4, 22, 43
  2900.                16,  17-19,  22-25,      volume report  3, 18, 22,  31,
  2901.                28,  29,   31,  35,                32, 38, 40
  2902.                36-38, 40, 41,  43,      write   4, 8, 10, 22,  33, 35,
  2903.                44-46                              41
  2904.      configuration    4, 6-9,  11,
  2905.                22, 42
  2906.      delete a disk  3, 22, 28
  2907.      delete/replace menu  3, 27
  2908.      dummy entry  3, 22, 23
  2909.      duplicate  files   3, 19, 22,
  2910.                33, 38
  2911.      editing  3, 11, 12, 25
  2912.      editing  string  fields    3,
  2913.                11, 25
  2914.      file search  3, 22, 30
  2915.      file/ext  report   3, 10, 17,
  2916.                19, 22, 32, 33, 38
  2917.      import  comments   4, 22, 43,
  2918.                44, 45
  2919.      installation  3, 5
  2920.      keyword search  3, 22, 30
  2921.      library  extensions   4,  22,
  2922.                41
  2923.      load  4, 8, 22, 42
  2924.      log floppy disks  3, 22, 23
  2925.      maximum files  4, 22, 41
  2926.      multiline  43
  2927.      Options  Menu   4, 6,  9, 10,
  2928.                17, 18, 31-33
  2929.      quick  file/ext  report    3,
  2930.                10, 22, 32
  2931.      quick  volume report   3, 22,
  2932.                32
  2933.  
  2934.         48                                              LogiCat Users Guide
  2935.